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

Requisito	Value
Plataforma de destino	Windows
Encabezado	deviceaccess.h
Library	Deviceaccess.lib
Archivo DLL	Deviceaccess.dll