CreateDeviceAccessInstance, fonction (deviceaccess.h)

Crée l’objet utilisé pour accéder à un appareil. L’objet instancié implémente les interfaces IDeviceIoControl et ICreateDeviceAccessAsync .

Conditions (FYI) :

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

Déclaration de l’en-tête.

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

Syntaxe

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

Paramètres

[in] deviceInterfacePath

Chemin d’accès d’interface d’appareil valide pour l’appareil auquel ce instance doit être lié.

[in] desiredAccess

Niveau d’accès demandé à l’appareil, qui peut être résumé en lecture, écriture, les deux ou ni l’un ni l’autre (zéro).

Les valeurs les plus couramment utilisées sont GENERIC_READ, GENERIC_WRITE ou les deux (GENERIC_READ | GENERIC_WRITE). Pour plus d’informations, consultez Droits d’accès génériques, Sécurité des fichiers et droits d’accès, Constantes des droits d’accès aux fichiers, Création et ouverture de fichiers et ACCESS_MASK.

createAsync

Interface asynchrone pour contrôler la liaison pour cette instance. Pour plus d’informations, consultez ICreateDeviceAccessAsync.

Valeur retournée

S_OK si l’objet sous-jacent et l’opération asynchrone sont créés avec succès ; une erreur appropriée dans le cas contraire. Notez que cette fonction n’exécute pas la liaison réelle. Cela se produit dans le cadre de l’opération asynchrone.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	deviceaccess.h
Bibliothèque	Deviceaccess.lib
DLL	Deviceaccess.dll