WDF_REQUEST_TYPE-Enumeration (wdfrequest.h)

Artikel
06/01/2023

[Gilt für KMDF und UMDF]

Der WDF_REQUEST_TYPE-Enumerationstyp identifiziert Typen von Anforderungen, die ein Frameworkanforderungsobjekt enthalten kann.

Syntax

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestTypeCreate = 0x0,
  WdfRequestTypeCreateNamedPipe = 0x1,
  WdfRequestTypeClose = 0x2,
  WdfRequestTypeRead = 0x3,
  WdfRequestTypeWrite = 0x4,
  WdfRequestTypeQueryInformation = 0x5,
  WdfRequestTypeSetInformation = 0x6,
  WdfRequestTypeQueryEA = 0x7,
  WdfRequestTypeSetEA = 0x8,
  WdfRequestTypeFlushBuffers = 0x9,
  WdfRequestTypeQueryVolumeInformation = 0xa,
  WdfRequestTypeSetVolumeInformation = 0xb,
  WdfRequestTypeDirectoryControl = 0xc,
  WdfRequestTypeFileSystemControl = 0xd,
  WdfRequestTypeDeviceControl = 0xe,
  WdfRequestTypeDeviceControlInternal = 0xf,
  WdfRequestTypeShutdown = 0x10,
  WdfRequestTypeLockControl = 0x11,
  WdfRequestTypeCleanup = 0x12,
  WdfRequestTypeCreateMailSlot = 0x13,
  WdfRequestTypeQuerySecurity = 0x14,
  WdfRequestTypeSetSecurity = 0x15,
  WdfRequestTypePower = 0x16,
  WdfRequestTypeSystemControl = 0x17,
  WdfRequestTypeDeviceChange = 0x18,
  WdfRequestTypeQueryQuota = 0x19,
  WdfRequestTypeSetQuota = 0x1A,
  WdfRequestTypePnp = 0x1B,
  WdfRequestTypeOther = 0x1C,
  WdfRequestTypeUsb = 0x40,
  WdfRequestTypeNoFormat = 0xFF,
  WdfRequestTypeMax
} WDF_REQUEST_TYPE;

Konstanten


`WdfRequestTypeCreate` Wert: 0x0 Das Anforderungsobjekt stellt eine IRP_MJ_CREATE Anforderung dar. Das Framework übermittelt diese Art von Anforderung an die EvtDeviceFileCreate-Rückruffunktion eines Treibers.
`WdfRequestTypeCreateNamedPipe` Wert: 0x1 Das Anforderungsobjekt stellt eine IRP_MJ_CREATE_NAMED_PIPE Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeClose` Wert: 0x2 Das Anforderungsobjekt stellt eine IRP_MJ_CLOSE Anforderung dar. Das Framework übermittelt diese Art von Anforderung an die EvtFileClose-Rückruffunktion eines Treibers.
`WdfRequestTypeRead` Wert: 0x3 Das Anforderungsobjekt stellt eine IRP_MJ_READ Anforderung dar. Das Framework übermittelt diesen Anforderungstyp an den Anforderungshandler eines Treibers.
`WdfRequestTypeWrite` Wert: 0x4 Das Anforderungsobjekt stellt eine IRP_MJ_WRITE Anforderung dar. Das Framework übermittelt diesen Anforderungstyp an den Anforderungshandler eines Treibers.
`WdfRequestTypeQueryInformation` Wert: 0x5 Das Anforderungsobjekt stellt eine IRP_MJ_QUERY_INFORMATION Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeSetInformation` Wert: 0x6 Das Anforderungsobjekt stellt eine IRP_MJ_SET_INFORMATION Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeQueryEA` Wert: 0x7 Das Anforderungsobjekt stellt eine IRP_MJ_QUERY_EA Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeSetEA` Wert: 0x8 Das Anforderungsobjekt stellt eine IRP_MJ_SET_EA Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeFlushBuffers` Wert: 0x9 Das Anforderungsobjekt stellt eine IRP_MJ_FLUSH_BUFFERS Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeQueryVolumeInformation` Wert: 0xa Das Anforderungsobjekt stellt eine IRP_MJ_QUERY_VOLUME_INFORMATION Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeSetVolumeInformation` Wert: 0xb Das Anforderungsobjekt stellt eine IRP_MJ_SET_VOLUME_INFORMATION Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeDirectoryControl` Wert: 0xc Das Anforderungsobjekt stellt eine IRP_MJ_DIRECTORY_CONTROL Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeFileSystemControl` Wert: 0xd Das Anforderungsobjekt stellt eine IRP_MJ_FILE_SYSTEM_CONTROL Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeDeviceControl` Wert: 0xe Das Anforderungsobjekt stellt eine IRP_MJ_DEVICE_CONTROL Anforderung dar. Das Framework übermittelt diesen Anforderungstyp an den Anforderungshandler eines Treibers.
`WdfRequestTypeDeviceControlInternal` Wert: 0xf Das Anforderungsobjekt stellt eine IRP_MJ_INTERNAL_DEVICE_CONTROL Anforderung dar. Das Framework übermittelt diesen Anforderungstyp an den Anforderungshandler eines Treibers.
`WdfRequestTypeShutdown` Wert: 0x10 Das Anforderungsobjekt stellt eine IRP_MJ_SHUTDOWN Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp für den Treiber, aber das Framework ruft auch die Rückruffunktion EvtDeviceShutdownNotification des Treibers auf, sofern vorhanden.
`WdfRequestTypeLockControl` Wert: 0x11 Das Anforderungsobjekt stellt eine IRP_MJ_LOCK_CONTROL-Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeCleanup` Wert: 0x12 Das Anforderungsobjekt stellt eine IRP_MJ_CLEANUP-Anforderung dar. Das Framework übermittelt diese Art von Anforderung an die EvtFileCleanup-Rückruffunktion eines Treibers.
`WdfRequestTypeCreateMailSlot` Wert: 0x13 Das Anforderungsobjekt stellt eine IRP_MJ_CREATE_MAILSLOT Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeQuerySecurity` Wert: 0x14 Das Anforderungsobjekt stellt eine IRP_MJ_QUERY_SECURITY Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeSetSecurity` Wert: 0x15 Das Anforderungsobjekt stellt eine IRP_MJ_SET_SECURITY Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypePower` Wert: 0x16 Das Anforderungsobjekt stellt eine IRP_MJ_POWER Anforderung dar. Das Framework verarbeitet diese Art von Anforderung für den Treiber, aber das Framework ruft auch die allgemeinen, FDO- und PDO-Rückruffunktionen des Treibers für Plug & Play (PnP) und Energieverwaltung auf, sofern die Rückruffunktionen vorhanden sind.
`WdfRequestTypeSystemControl` Wert: 0x17 Das Anforderungsobjekt stellt eine IRP_MJ_SYSTEM_CONTROL Anforderung dar. Das Framework verarbeitet diese Art von Anforderung für den Treiber, wenn der Treiber die Windows-Verwaltungsinstrumentation (WMI) unterstützt.
`WdfRequestTypeDeviceChange` Wert: 0x18 Das Anforderungsobjekt stellt eine IRP_MJ_DEVICE_CHANGE Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeQueryQuota` Wert: 0x19 Das Anforderungsobjekt stellt eine IRP_MJ_QUERY_QUOTA Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypeSetQuota` Wert: 0x1A Das Anforderungsobjekt stellt eine IRP_MJ_SET_QUOTA Anforderung dar. Das Framework verarbeitet diesen Anforderungstyp nicht.
`WdfRequestTypePnp` Wert: 0x1B Das Anforderungsobjekt stellt eine IRP_MJ_PNP Anforderung dar. Das Framework verarbeitet diese Art von Anforderung für den Treiber, aber das Framework ruft auch die allgemeinen, FDO- und PDO-Rückruffunktionen des Treibers für PnP und Energieverwaltung auf, sofern die Rückruffunktionen vorhanden sind.
`WdfRequestTypeOther` Wert: 0x1C Ein Treiber empfängt diesen Anforderungstyp in seiner CompletionRoutine-Ereignisrückruffunktion, wenn anforderungen, die mit WdfIoTargetFormatRequestForInternalIoctlOthers formatiert sind, abgeschlossen sind.
`WdfRequestTypeUsb` Wert: 0x40 Das Zielgerät ist ein USB-Gerät. (Dieser Wert wird nur in WDF_REQUEST_COMPLETION_PARAMS-Strukturen verwendet.)
`WdfRequestTypeNoFormat` Wert: 0xFF Der Typ des Anforderungsobjekts wurde nicht angegeben.
`WdfRequestTypeMax` Der maximale Wert, der einem gültigen IRP-Hauptfunktionscode zugewiesen wurde.

Hinweise

Der WDF_REQUEST_TYPE Enumerationstyp wird in den WDF_REQUEST_PARAMETERS - und WDF_REQUEST_COMPLETION_PARAMS-Strukturen verwendet.

Informationen dazu, wie ein frameworkbasierter Treiber Anforderungstypen behandeln kann, die vom Framework nicht unterstützt werden, finden Sie unter Behandeln einer IRP, die das Framework nicht unterstützt.

Die UMDF-Version dieser Enumeration finden Sie unter WDF_REQUEST_TYPE (UMDF).