CreateDeviceAccessInstance-Funktion (deviceaccess.h)

  • Artikel

Erstellt das Objekt, das für den Zugriff auf ein Gerät verwendet wird. Das instanziierte Objekt implementiert die Schnittstellen IDeviceIoControl und ICreateDeviceAccessAsync .

Bedingungen (JJ):


 !defined(__deviceaccess_h__) [-AND-]  ((NTDDI_VERSION >= NTDDI_WIN8)) [-AND-]  defined(__cplusplus)

Deklaration aus dem Header.


 HRESULT WINAPI  
CreateDeviceAccessInstance(  
    _In_ LPCWSTR deviceInterfacePath,  
    _In_ DWORD desiredAccess,  
    _Outptr_ ICreateDeviceAccessAsync **createAsync  
    );

Syntax

HRESULT CreateDeviceAccessInstance(
  [in] PCWSTR                   deviceInterfacePath,
  [in] DWORD                    desiredAccess,
       ICreateDeviceAccessAsync **createAsync
);

Parameter

[in] deviceInterfacePath

Ein gültiger Geräteschnittstellenpfad für das Gerät, an das dieses instance gebunden werden soll.

[in] desiredAccess

Die angeforderte Zugriffsebene auf das Gerät, die als Lese-, Schreib-, beides- oder keines (Null) zusammengefasst werden kann.

Die am häufigsten verwendeten Werte sind GENERIC_READ, GENERIC_WRITE oder beide (GENERIC_READ | GENERIC_WRITE). Weitere Informationen finden Sie unter Generische Zugriffsrechte, Dateisicherheit und Zugriffsrechte, Dateizugriffsrechtekonstanten, Erstellen und Öffnen von Dateien und ACCESS_MASK.

createAsync

Asynchrone Schnittstelle zum Steuern der Bindung für diese instance. Weitere Informationen finden Sie unter ICreateDeviceAccessAsync.

Rückgabewert

S_OK , wenn das zugrunde liegende Objekt und der asynchrone Vorgang erfolgreich erstellt wurden; andernfalls ein entsprechender Fehler. Beachten Sie, dass diese Funktion die tatsächliche Bindung nicht ausführt. Dies geschieht im Rahmen des asynchronen Vorgangs.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile deviceaccess.h
Bibliothek Deviceaccess.lib
DLL Deviceaccess.dll