estrutura WDF_DRIVER_CONFIG (wdfdriver.h)
[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 do 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 digitado por WDF_DRIVER_INIT_FLAGSque identificam sinalizadores de inicialização do driver.
DriverPoolTag
(KMDF versões 1.5 e posterior.) 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.
Observações
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, em 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.
Requisitos
| Requisito | Valor |
|---|---|
| versão mínima do KMDF | 1.0 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfdriver.h (inclua Wdf.h) |