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

Weitere Informationen

IWDFIoRequest

IWDFIoRequest::GetInputMemory

IWDFIoRequest::GetOutputMemory