WDF_REQUEST_TYPE-Enumeration (wudfddi_types.h)

Artikel
08/08/2023

[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 in neueren 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 WDF_REQUEST_TYPE-Enumeration identifiziert die Typen von E/A-Anforderungen, die ein UMDF-Anforderungsobjekt darstellen kann.

Syntax

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

Konstanten


`WdfRequestUndefined` Der Typ des Anforderungsobjekts ist nicht definiert.
`WdfRequestCreate` Das Anforderungsobjekt stellt eine Dateierstellungsanforderung dar. Der Treiber empfängt diese Art von Anforderungsobjekt, wenn eine Anwendung ein Gerät durch Aufrufen der CreateFile-Funktion von Microsoft Win32 öffnet. Das Framework übermittelt diesen Anforderungstyp zusammen mit einem neu erstellten Dateiobjekt (IWDFFile) an die Rückruffunktion IQueueCallbackCreate::OnCreateFile des Treibers. Das neue Dateiobjekt stellt das HANDLE-typisierte Dateihandle dar, das von Win32 CreateFile zurückgegeben wird.
`WdfRequestCleanup` Das Anforderungsobjekt stellt eine Dateibereinigungsanforderung dar. Der Treiber empfängt diese Art von Anforderungsobjekt, nachdem der Aufruf einer Anwendung der Win32 CloseHandle-Funktion das letzte Handle für ein Dateiobjekt schließt, aber möglicherweise, bevor alle ausstehenden E/A-Anforderungen der Datei abgeschlossen oder abgebrochen wurden. Das Framework übermittelt diese Art von Anforderung an die IFileCallbackCleanup::OnCleanupFile-Rückruffunktion des Treibers. (Siehe auch WdfRequestClose.)
`WdfRequestRead` Das Anforderungsobjekt stellt eine Leseanforderung dar. Dieser Treiber empfängt diese Art von E/A-Anforderung, wenn eine Anwendung die Win32 ReadFile- oder ReadFileEx-Funktion aufruft . Das Framework übermittelt diesen Anforderungstyp an die IQueueCallbackRead::OnRead-Rückruffunktion des Treibers.
`WdfRequestWrite` Das Anforderungsobjekt stellt eine Schreibanforderung dar. Dieser Treiber empfängt diese Art von E/A-Anforderung, wenn eine Anwendung die Win32 WriteFile - oder WriteFileEx-Funktion aufruft . Das Framework übermittelt diesen Anforderungstyp an die IQueueCallbackWrite::OnWrite-Rückruffunktion des Treibers.
`WdfRequestDeviceIoControl` Das Anforderungsobjekt stellt eine Geräte-E/A-Steuerungsanforderung dar. Dieser Treiber empfängt diese Art von E/A-Anforderung, wenn eine Anwendung die Win32 DeviceIoControl-Funktion aufruft . Das Framework übermittelt diesen Anforderungstyp an die Rückruffunktion IQueueCallbackDeviceIoControl::OnDeviceIoControl des Treibers.
`WdfRequestClose` Das Anforderungsobjekt stellt eine Anforderung zum Schließen von Dateien dar. Der Treiber empfängt diesen Typ von Anforderungsobjekt, nachdem der Aufruf der Win32 CloseHandle-Funktion durch eine Anwendung das letzte Handle für ein Dateiobjekt schließt und nachdem alle ausstehenden E/A-Anforderungen der Datei abgeschlossen oder abgebrochen wurden. Das Framework übermittelt diesen Anforderungstyp an die Rückruffunktion IFileCallbackClose::OnCloseFile des Treibers. (Siehe auch WdfRequestCleanup.)
`WdfRequestUsb` Das Anforderungsobjekt wurde an einen USB-Anschluss gesendet. Die IWDFRequestCompletionParams::GetCompletedRequestType-Methode kann diesen Wert zurückgeben.
`WdfRequestOther` Dieser Wert ist nur für die interne Verwendung reserviert.
`WdfRequestInternalIoctl` Dieser Wert ist nur für die interne Verwendung reserviert.
`WdfRequestTypeNoFormat` Der Typ des Anforderungsobjekts wurde nicht angegeben.
`WdfRequestFlushBuffers` Das Anforderungsobjekt stellt eine Anforderung zum Leeren zwischengespeicherter Puffer dar. Das Framework übermittelt diesen Anforderungstyp an die Rückruffunktion IQueueCallbackDefaultIoHandler::OnDefaultIoHandler des Treibers.
`WdfRequestQueryInformation` Das Anforderungsobjekt stellt eine Anforderung zum Abrufen von Informationen zu einer Datei dar. Das Framework übermittelt diesen Anforderungstyp an die Rückruffunktion IQueueCallbackDefaultIoHandler::OnDefaultIoHandler des Treibers.
`WdfRequestSetInformation` Das Anforderungsobjekt stellt eine Anforderung zum Festlegen von Informationen zu einer Datei dar. Das Framework übermittelt diesen Anforderungstyp an die Rückruffunktion IQueueCallbackDefaultIoHandler::OnDefaultIoHandler des Treibers.
`WdfRequestMaximum` Der maximal zulässige Wert für die Enumeration wird überschritten.