Método IDeviceIoControl::D eviceIoControlAsync (deviceaccess.h)
O método DeviceIoControlAsync envia uma solicitação de controle de entrada/saída de dispositivo assíncrona (E/S) para a interface do dispositivo que a chamada para a função CreateDeviceAccessInstance especificou.
Sintaxe
HRESULT DeviceIoControlAsync(
[in] DWORD ioControlCode,
[in] UCHAR *inputBuffer,
[in] DWORD inputBufferSize,
[out] UCHAR *outputBuffer,
[in] DWORD outputBufferSize,
[in] IDeviceRequestCompletionCallback *requestCompletionCallback,
[out] ULONG_PTR *cancelContext
);
Parâmetros
[in] ioControlCode
O código de controle de E/S para a operação.
[in] inputBuffer
Um buffer de entrada opcional para a operação.
[in] inputBufferSize
O tamanho do buffer de entrada, em bytes.
[out] outputBuffer
Um buffer de saída operacional para a operação.
[in] outputBufferSize
O tamanho do buffer de saída, em bytes.
[in] requestCompletionCallback
A interface de retorno de chamada na qual o método RequestCompletion será chamado se a operação for enviada com êxito.
[out] cancelContext
Um ponteiro opcional que recebe um contexto de cancelamento que pode ser passado para o método CancelOperation para cancelar uma solicitação pendente.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Se a solicitação for enviada com êxito (ou seja, chamar essa função não retornará imediatamente um erro), o resultado da operação estará disponível no retorno de chamada RequestCompletion da interface IDeviceRequestCompletionCallback fornecida.
Uma operação que o sistema (sistema operacional ou driver de dispositivo) falha imediatamente não resulta em um retorno de chamada. Isso significa que o chamador receberá um retorno de chamada somente se essa função retornar S_OK.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | deviceaccess.h |
| Biblioteca | Deviceaccess.lib |