enumerazione WDF_REQUEST_TYPE (wdfrequest.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

Il tipo di enumerazione WDF_REQUEST_TYPE identifica i tipi di richieste che un oggetto richiesta framework potrebbe contenere.

Sintassi

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;

Costanti


`WdfRequestTypeCreate` Valore: 0x0 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_CREATE . Il framework fornisce questo tipo di richiesta alla funzione di callback EvtDeviceFileCreate di un driver.
`WdfRequestTypeCreateNamedPipe` Valore: 0x1 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_CREATE_NAMED_PIPE . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeClose` Valore: 0x2 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_CLOSE . Il framework fornisce questo tipo di richiesta alla funzione di callback EvtFileClose di un driver.
`WdfRequestTypeRead` Valore: 0x3 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_READ . Il framework recapita questo tipo di richiesta al gestore richieste di un driver.
`WdfRequestTypeWrite` Valore: 0x4 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_WRITE . Il framework recapita questo tipo di richiesta al gestore richieste di un driver.
`WdfRequestTypeQueryInformation` Valore: 0x5 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_QUERY_INFORMATION . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeSetInformation` Valore: 0x6 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SET_INFORMATION . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeQueryEA` Valore: 0x7 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_QUERY_EA . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeSetEA` Valore: 0x8 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SET_EA . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeFlushBuffers` Valore: 0x9 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_FLUSH_BUFFERS . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeQueryVolumeInformation` Valore: 0xa L'oggetto richiesta rappresenta una richiesta di IRP_MJ_QUERY_VOLUME_INFORMATION . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeSetVolumeInformation` Valore: 0xb L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SET_VOLUME_INFORMATION . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeDirectoryControl` Valore: 0xc L'oggetto richiesta rappresenta una richiesta di IRP_MJ_DIRECTORY_CONTROL . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeFileSystemControl` Valore: 0xd L'oggetto richiesta rappresenta una richiesta di IRP_MJ_FILE_SYSTEM_CONTROL . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeDeviceControl` Valore: 0xe L'oggetto richiesta rappresenta una richiesta di IRP_MJ_DEVICE_CONTROL . Il framework recapita questo tipo di richiesta al gestore richieste di un driver.
`WdfRequestTypeDeviceControlInternal` Valore: 0xf L'oggetto richiesta rappresenta una richiesta di IRP_MJ_INTERNAL_DEVICE_CONTROL . Il framework recapita questo tipo di richiesta al gestore richieste di un driver.
`WdfRequestTypeShutdown` Valore: 0x10 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SHUTDOWN . Il framework gestisce questo tipo di richiesta per il driver, ma il framework chiama anche la funzione di callback EvtDeviceShutdownNotification del driver, se esistente.
`WdfRequestTypeLockControl` Valore: 0x11 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_LOCK_CONTROL . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeCleanup` Valore: 0x12 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_CLEANUP . Il framework fornisce questo tipo di richiesta alla funzione di callback EvtFileCleanup di un driver.
`WdfRequestTypeCreateMailSlot` Valore: 0x13 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_CREATE_MAILSLOT . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeQuerySecurity` Valore: 0x14 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_QUERY_SECURITY . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeSetSecurity` Valore: 0x15 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SET_SECURITY . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypePower` Valore: 0x16 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_POWER . Il framework gestisce questo tipo di richiesta per il driver, ma il framework chiama anche le funzioni di callback generale, FDO e PDO del driver per Plug and Play (PnP) e risparmio energia, se esistono le funzioni di callback.
`WdfRequestTypeSystemControl` Valore: 0x17 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SYSTEM_CONTROL . Il framework gestisce questo tipo di richiesta per il driver, se il driver supporta Strumentazione gestione Windows (WMI).
`WdfRequestTypeDeviceChange` Valore: 0x18 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_DEVICE_CHANGE . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeQueryQuota` Valore: 0x19 L'oggetto richiesta rappresenta una richiesta di IRP_MJ_QUERY_QUOTA . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypeSetQuota` Valore: 0x1A L'oggetto richiesta rappresenta una richiesta di IRP_MJ_SET_QUOTA . Il framework non gestisce questo tipo di richiesta.
`WdfRequestTypePnp` Valore: 0x1B L'oggetto richiesta rappresenta una richiesta di IRP_MJ_PNP . Il framework gestisce questo tipo di richiesta per il driver, ma il framework chiama anche le funzioni di callback generale, FDO e PDO del driver per PnP e risparmio energia, se esistono le funzioni di callback.
`WdfRequestTypeOther` Valore: 0x1C Un driver riceve questo tipo di richiesta nella funzione di callback dell'evento CompletionRoutine quando le richieste formattate con WdfIoTargetFormatRequestForInternalIoctlOthers vengono completate .
`WdfRequestTypeUsb` Valore: 0x40 Il dispositivo di destinazione è un dispositivo USB. Questo valore viene usato solo nelle strutture WDF_REQUEST_COMPLETION_PARAMS .
`WdfRequestTypeNoFormat` Valore: 0xFF Il tipo dell'oggetto richiesta non è stato specificato.
`WdfRequestTypeMax` Valore massimo assegnato a un codice di funzione principale IRP valido.

Commenti

Il tipo di enumerazione WDF_REQUEST_TYPE viene usato nelle strutture di WDF_REQUEST_PARAMETERS e WDF_REQUEST_COMPLETION_PARAMS.

Per informazioni sul modo in cui un driver basato su framework può gestire i tipi di richiesta che il framework non supporta, vedere Gestione di un'IRP non supportata da Framework.

Per la versione UMDF di questa enumerazione, vedere WDF_REQUEST_TYPE (UMDF).