IDeviceIoControl::D eviceIoControlAsync-Methode (deviceaccess.h)
Die DeviceIoControlAsync-Methode sendet eine asynchrone Geräteeingabe-/Ausgabe-Steuerelementanforderung (E/A) an die Geräteschnittstelle, die der Aufruf der CreateDeviceAccessInstance-Funktion angegeben hat.
Syntax
HRESULT DeviceIoControlAsync(
[in] DWORD ioControlCode,
[in] UCHAR *inputBuffer,
[in] DWORD inputBufferSize,
[out] UCHAR *outputBuffer,
[in] DWORD outputBufferSize,
[in] IDeviceRequestCompletionCallback *requestCompletionCallback,
[out] ULONG_PTR *cancelContext
);
Parameter
[in] ioControlCode
Der E/A-Steuerungscode für den Vorgang.
[in] inputBuffer
Ein optionaler Eingabepuffer für den Vorgang.
[in] inputBufferSize
Die Größe des Eingabepuffers in Bytes.
[out] outputBuffer
Ein betriebsbereiter Ausgabepuffer für den Vorgang.
[in] outputBufferSize
Die Größe des Ausgabepuffers in Bytes.
[in] requestCompletionCallback
Die Rückrufschnittstelle, auf der die RequestCompletion-Methode aufgerufen wird, wenn der Vorgang erfolgreich übermittelt wurde.
[out] cancelContext
Ein optionaler Zeiger, der einen Abbruchkontext empfängt, der an die CancelOperation-Methode übergeben werden kann, um eine ausstehende Anforderung abzubrechen.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn die Anforderung erfolgreich übermittelt wurde (d. h. das Aufrufen dieser Funktion gibt nicht sofort einen Fehler zurück), ist das Ergebnis des Vorgangs im RequestCompletion-Rückruf der angegebenen IDeviceRequestCompletionCallback-Schnittstelle verfügbar.
Ein Vorgang, bei dem das System (Betriebssystem oder Gerätetreiber) sofort fehlschlägt, führt nicht zu einem Rückruf. Dies bedeutet, dass der Aufrufer nur dann einen Rückruf empfängt, wenn diese Funktion S_OK zurückgibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | deviceaccess.h |
| Bibliothek | Deviceaccess.lib |