IWDFIoRequest::GetDeviceIoControlParameters-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die GetDeviceIoControlParameters-Methode ruft die Anforderungsparameter für eine Geräte-E/A-Steuerelementtypanforderung ab.
Syntax
void GetDeviceIoControlParameters(
[out] ULONG *pControlCode,
[out] SIZE_T *pInBufferSize,
[out] SIZE_T *pOutBufferSize
);
Parameter
[out] pControlCode
Ein Zeiger auf eine Variable, die den Steuerungscode empfängt, der den spezifischen auszuführenden Vorgang identifiziert.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.
[out] pInBufferSize
Ein Zeiger auf eine Variable, die die Größe des Eingabedatenpuffers für die Anforderung in Bytes empfängt. Um den Eingabedatenpuffer abzurufen, ruft der Treiber die IWDFIoRequest::GetInputMemory-Methode auf.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.
[out] pOutBufferSize
Ein Zeiger auf eine Variable, die die Größe des Ausgabedatenpuffers für die Anforderung in Bytes empfängt. Um den Ausgabedatenpuffer abzurufen, ruft der Treiber die IWDFIoRequest::GetOutputMemory-Methode auf.
Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.
Rückgabewert
Keine
Bemerkungen
Der Aufruf von GetDeviceIoControlParameters schlägt fehl, wenn der Anforderungstyp kein Geräte-E/A-Steuerelementtyp ist.
Obwohl der Treiber optional NULL für jeden der Parameter pControlCode, pInBufferSize und pOutBufferSize angeben kann, muss der Treiber mindestens einen Nicht-NULL-Parameter angeben, damit GetDeviceIoControlParameters erfolgreich ausgeführt werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |