Condividi tramite

Funzione CreateDeviceAccessInstance (deviceaccess.h)

  • Articolo

Crea l'oggetto utilizzato per accedere a un dispositivo. L'oggetto di cui è stata creata un'istanza implementa le interfacce IDeviceIoControl e ICreateDeviceAccessAsync .

Condizioni (FYI):


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

Dichiarazione dall'intestazione.


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

Sintassi

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

Parametri

[in] deviceInterfacePath

Percorso dell'interfaccia dispositivo valido per il dispositivo a cui deve essere associata questa istanza.

[in] desiredAccess

Livello di accesso richiesto al dispositivo, che può essere riepilogato come lettura, scrittura, entrambi o nessuno (zero).

I valori usati più di frequente sono GENERIC_READ, GENERIC_WRITE o entrambi (GENERIC_READ GENERIC_WRITE | ). Per altre informazioni, vedere Diritti di accesso generico, sicurezza dei file e diritti di accesso, costanti dei diritti di accesso ai file, creazione e apertura di file e ACCESS_MASK.

createAsync

Interfaccia asincrona per controllare l'associazione per questa istanza. Per altre informazioni, vedere ICreateDeviceAccessAsync.

Valore restituito

S_OK se l'oggetto sottostante e l'operazione asincrona vengono creati correttamente; un errore appropriato in caso contrario. Si noti che questa funzione non esegue l'associazione effettiva. Ciò avviene come parte dell'operazione asincrona.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione deviceaccess.h
Libreria Deviceaccess.lib
DLL Deviceaccess.dll