Función CreateDeviceAccessInstance (deviceaccess.h)

Crea el objeto que se usa para acceder a un dispositivo. El objeto creado por instancias implementa las interfaces IDeviceIoControl e ICreateDeviceAccessAsync .

Condiciones (FYI):

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

Declaración del encabezado.

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

Sintaxis

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

Parámetros

[in] deviceInterfacePath

Ruta de acceso de interfaz de dispositivo válida para el dispositivo al que debe enlazar esta instancia.

[in] desiredAccess

Nivel de acceso solicitado al dispositivo, que se puede resumir como lectura, escritura, ambos o ninguno (cero).

Los valores más usados son GENERIC_READ, GENERIC_WRITE o ambos (GENERIC_READ | GENERIC_WRITE). Para obtener más información, vea Derechos de acceso genéricos, Derechos de seguridad de archivos y Derechos de acceso, Constantes de derechos de acceso a archivos, Crear y abrir archivos y ACCESS_MASK.

createAsync

Interfaz asincrónica para controlar el enlace de esta instancia. Para obtener más información, vea ICreateDeviceAccessAsync.

Valor devuelto

S_OK si el objeto subyacente y la operación asincrónica se crean correctamente; Un error adecuado de lo contrario. Tenga en cuenta que esta función no realiza el enlace real. Esto sucede como parte de la operación asincrónica.

Requisitos