WDF_REQUEST_TYPE enumeração (wdfrequest.h)

Artigo
06/01/2023

[Aplica-se a KMDF e UMDF]

O tipo de enumeração WDF_REQUEST_TYPE identifica tipos de solicitações que um objeto de solicitação de estrutura pode conter.

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;

Constantes


`WdfRequestTypeCreate` Valor: 0x0 O objeto de solicitação representa uma solicitação IRP_MJ_CREATE . A estrutura fornece esse tipo de solicitação para a função de retorno de chamada EvtDeviceFileCreate de um driver.
`WdfRequestTypeCreateNamedPipe` Valor: 0x1 O objeto de solicitação representa uma solicitação IRP_MJ_CREATE_NAMED_PIPE . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeClose` Valor: 0x2 O objeto de solicitação representa uma solicitação IRP_MJ_CLOSE . A estrutura fornece esse tipo de solicitação para a função de retorno de chamada EvtFileClose de um driver.
`WdfRequestTypeRead` Valor: 0x3 O objeto de solicitação representa uma solicitação IRP_MJ_READ . A estrutura fornece esse tipo de solicitação para o manipulador de solicitação de um driver.
`WdfRequestTypeWrite` Valor: 0x4 O objeto de solicitação representa uma solicitação IRP_MJ_WRITE . A estrutura fornece esse tipo de solicitação para o manipulador de solicitação de um driver.
`WdfRequestTypeQueryInformation` Valor: 0x5 O objeto de solicitação representa uma solicitação IRP_MJ_QUERY_INFORMATION . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeSetInformation` Valor: 0x6 O objeto de solicitação representa uma solicitação IRP_MJ_SET_INFORMATION . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeQueryEA` Valor: 0x7 O objeto de solicitação representa uma solicitação IRP_MJ_QUERY_EA . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeSetEA` Valor: 0x8 O objeto de solicitação representa uma solicitação IRP_MJ_SET_EA . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeFlushBuffers` Valor: 0x9 O objeto de solicitação representa uma solicitação IRP_MJ_FLUSH_BUFFERS . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeQueryVolumeInformation` Valor: 0xa O objeto de solicitação representa uma solicitação IRP_MJ_QUERY_VOLUME_INFORMATION . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeSetVolumeInformation` Valor: 0xb O objeto de solicitação representa uma solicitação IRP_MJ_SET_VOLUME_INFORMATION . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeDirectoryControl` Valor: 0xc O objeto de solicitação representa uma solicitação IRP_MJ_DIRECTORY_CONTROL . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeFileSystemControl` Valor: 0xd O objeto de solicitação representa uma solicitação IRP_MJ_FILE_SYSTEM_CONTROL . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeDeviceControl` Valor: 0xe O objeto de solicitação representa uma solicitação IRP_MJ_DEVICE_CONTROL . A estrutura fornece esse tipo de solicitação para o manipulador de solicitação de um driver.
`WdfRequestTypeDeviceControlInternal` Valor: 0xf O objeto de solicitação representa uma solicitação IRP_MJ_INTERNAL_DEVICE_CONTROL . A estrutura fornece esse tipo de solicitação para o manipulador de solicitação de um driver.
`WdfRequestTypeShutdown` Valor: 0x10 O objeto de solicitação representa uma solicitação IRP_MJ_SHUTDOWN . A estrutura lida com esse tipo de solicitação para o driver, mas a estrutura também chama a função de retorno de chamada EvtDeviceShutdownNotification do driver, se ela existir.
`WdfRequestTypeLockControl` Valor: 0x11 O objeto de solicitação representa uma solicitação IRP_MJ_LOCK_CONTROL . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeCleanup` Valor: 0x12 O objeto de solicitação representa uma solicitação IRP_MJ_CLEANUP . A estrutura fornece esse tipo de solicitação para a função de retorno de chamada EvtFileCleanup de um driver.
`WdfRequestTypeCreateMailSlot` Valor: 0x13 O objeto de solicitação representa uma solicitação IRP_MJ_CREATE_MAILSLOT . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeQuerySecurity` Valor: 0x14 O objeto de solicitação representa uma solicitação IRP_MJ_QUERY_SECURITY . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeSetSecurity` Valor: 0x15 O objeto de solicitação representa uma solicitação IRP_MJ_SET_SECURITY . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypePower` Valor: 0x16 O objeto de solicitação representa uma solicitação IRP_MJ_POWER . A estrutura lida com esse tipo de solicitação para o driver, mas a estrutura também chama as funções de retorno de chamada geral, FDO e PDO do driver para Plug and Play (PnP) e gerenciamento de energia, se as funções de retorno de chamada existirem.
`WdfRequestTypeSystemControl` Valor: 0x17 O objeto de solicitação representa uma solicitação IRP_MJ_SYSTEM_CONTROL . A estrutura manipulará esse tipo de solicitação para o driver, se o driver der suporte à WMI (Instrumentação de Gerenciamento do Windows).
`WdfRequestTypeDeviceChange` Valor: 0x18 O objeto de solicitação representa uma solicitação IRP_MJ_DEVICE_CHANGE . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeQueryQuota` Valor: 0x19 O objeto de solicitação representa uma solicitação IRP_MJ_QUERY_QUOTA . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypeSetQuota` Valor: 0x1A O objeto de solicitação representa uma solicitação IRP_MJ_SET_QUOTA . A estrutura não manipula esse tipo de solicitação.
`WdfRequestTypePnp` Valor: 0x1B O objeto de solicitação representa uma solicitação IRP_MJ_PNP . A estrutura lida com esse tipo de solicitação para o driver, mas a estrutura também chama as funções de retorno de chamada geral, FDO e PDO do driver para PnP e gerenciamento de energia, se as funções de retorno de chamada existirem.
`WdfRequestTypeOther` Valor: 0x1C Um driver recebe esse tipo de solicitação em sua função de retorno de chamada de evento CompletionRoutine quando as solicitações formatadas com WdfIoTargetFormatRequestForInternalIoctlOthers são concluídas .
`WdfRequestTypeUsb` Valor: 0x40 O dispositivo de destino é um dispositivo USB. (Esse valor é usado apenas em estruturas de WDF_REQUEST_COMPLETION_PARAMS .)
`WdfRequestTypeNoFormat` Valor: 0xFF O tipo do objeto de solicitação não foi especificado.
`WdfRequestTypeMax` O valor máximo que foi atribuído a um código de função principal IRP válido.

Comentários

O tipo de enumeração WDF_REQUEST_TYPE é usado nas estruturas WDF_REQUEST_PARAMETERS e WDF_REQUEST_COMPLETION_PARAMS .

Para obter informações sobre como um driver baseado em estrutura pode lidar com tipos de solicitação aos quais a estrutura não dá suporte, consulte Manipulando um IRP que a Estrutura não dá suporte.

Para obter a versão UMDF dessa enumeração, consulte WDF_REQUEST_TYPE (UMDF).