Compartilhar via


Função CreateDeviceAccessInstance (deviceaccess.h)

Cria o objeto usado para acessar um dispositivo. O objeto instanciado implementa as interfaces IDeviceIoControl e ICreateDeviceAccessAsync .

Condições (FYI):


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

Declaração do cabeçalho.


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

Sintaxe

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

Parâmetros

[in] deviceInterfacePath

Um caminho de interface do dispositivo válido para o dispositivo ao qual essa instância deve ser associada.

[in] desiredAccess

O nível solicitado de acesso ao dispositivo, que pode ser resumido como leitura, gravação, ambos ou nenhum (zero).

Os valores mais usados são GENERIC_READ, GENERIC_WRITE ou ambos (GENERIC_READ | GENERIC_WRITE). Para obter mais informações, consulte Direitos de Acesso Genéricos, Segurança de Arquivos e Direitos de Acesso, Constantes de Direitos de Acesso a Arquivos, Criação e Abertura de Arquivos e ACCESS_MASK.

createAsync

Interface assíncrona para controlar a associação para essa instância. Para obter mais informações, consulte ICreateDeviceAccessAsync.

Retornar valor

S_OK se o objeto subjacente e a operação assíncrona forem criados com êxito; caso contrário, um erro apropriado. Observe que essa função não executa a associação real. Isso acontece como parte da operação assíncrona.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho deviceaccess.h
Biblioteca Deviceaccess.lib
DLL Deviceaccess.dll