estrutura WDF_DRIVER_CONFIG (wdfdriver.h)

Artigo
08/08/2023

[Aplica-se a KMDF e UMDF]

A estrutura WDF_DRIVER_CONFIG é um parâmetro de entrada para WdfDriverCreate.

Sintaxe

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Membros

Size

O tamanho, em bytes, dessa estrutura.

EvtDriverDeviceAdd

Um ponteiro para a função de retorno de chamada EvtDriverDeviceAdd de um driver.

EvtDriverUnload

Um ponteiro para a função de retorno de chamada EvtDriverUnload de um driver.

DriverInitFlags

Um OR bit a bit de um ou mais valores de tipo WDF_DRIVER_INIT_FLAGS que identificam sinalizadores de inicialização de driver.

DriverPoolTag

(KMDF versões 1.5 e posteriores.) Uma marca de pool definida pelo driver que a estrutura atribuirá a todas as alocações de pool do driver. Os depuradores exibem essa marca. Para obter mais informações sobre como especificar uma marca de pool, consulte a seção Comentários a seguir.

Comentários

Opcionalmente, o driver pode especificar uma marca de pool que a estrutura atribuirá a todas as alocações de pool do driver. Os drivers normalmente especificam uma cadeia de caracteres de até quatro caracteres, delimitada por aspas simples, na ordem inversa (por exemplo, 'dcba'). O valor ASCII de cada caractere na marca deve estar entre 0 e 127.

Se DriverPoolTag for zero, a estrutura criará uma marca de pool padrão usando os quatro primeiros caracteres do nome do serviço do modo kernel do driver. Se o nome do serviço começar com "WDF" (o nome não diferencia maiúsculas de minúsculas e não inclui as aspas), os próximos quatro caracteres serão usados. Se menos de quatro caracteres estiverem disponíveis, "FxDr" será usado.

Para inicializar uma estrutura de WDF_DRIVER_CONFIG, os drivers devem chamar WDF_DRIVER_CONFIG_INIT.