Leggere in inglese

Condividi tramite

Metodo IDeviceIoControl::D eviceIoControlAsync (deviceaccess.h)

  • Articolo
  • 29/02/2024

Il metodo DeviceIoControlAsync invia una richiesta di controllo di input/output del dispositivo asincrona (I/O) all'interfaccia del dispositivo che la chiamata alla funzione CreateDeviceAccessInstance specificata.

Sintassi

HRESULT DeviceIoControlAsync(
  [in]  DWORD                            ioControlCode,
  [in]  UCHAR                            *inputBuffer,
  [in]  DWORD                            inputBufferSize,
  [out] UCHAR                            *outputBuffer,
  [in]  DWORD                            outputBufferSize,
  [in]  IDeviceRequestCompletionCallback *requestCompletionCallback,
  [out] ULONG_PTR                        *cancelContext
);

Parametri

[in] ioControlCode

Codice di controllo di I/O per l'operazione.

[in] inputBuffer

Buffer di input facoltativo per l'operazione.

[in] inputBufferSize

Dimensioni del buffer di input, in byte.

[out] outputBuffer

Buffer di output operativo per l'operazione.

[in] outputBufferSize

Dimensioni del buffer di output, in byte.

[in] requestCompletionCallback

Interfaccia di callback in cui viene chiamato il metodo RequestCompletion se l'operazione viene inviata correttamente.

[out] cancelContext

Puntatore facoltativo che riceve un contesto di annullamento che può essere passato al metodo CancelOperation per annullare una richiesta in sospeso.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se la richiesta viene inviata correttamente, ovvero la chiamata a questa funzione non restituisce immediatamente un errore, il risultato dell'operazione è disponibile nel callback RequestCompletion dell'interfaccia IDeviceRequestCompletionCallback fornita.

Un'operazione che il sistema (sistema operativo o driver di dispositivo) ha esito negativo immediatamente non genera un callback. Ciò significa che il chiamante riceve un callback solo se questa funzione restituisce S_OK.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione deviceaccess.h
Libreria Deviceaccess.lib

Vedi anche

IDeviceIoControl

Risorse aggiuntive