Metodo IDeviceIoControl::D eviceIoControlAsync (deviceaccess.h)
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 |