estrutura WDF_DPC_CONFIG (wdfdpc.h)

Artigo
02/27/2024

[Aplica-se somente ao KMDF]

A estrutura WDF_DPC_CONFIG contém informações de configuração para um objeto DPC.

Sintaxe

typedef struct _WDF_DPC_CONFIG {
  ULONG       Size;
  PFN_WDF_DPC EvtDpcFunc;
  BOOLEAN     AutomaticSerialization;
} WDF_DPC_CONFIG, *PWDF_DPC_CONFIG;

Membros

Size

O tamanho, em bytes, dessa estrutura.

EvtDpcFunc

Um ponteiro para a função de retorno de chamada EvtDpcFunc do driver.

AutomaticSerialization

Um valor booliano que, se TRUE, indica que a estrutura sincronizará a execução da função de retorno de chamada EvtDpcFunc do objeto DPC com funções de retorno de chamada de outros objetos que estão abaixo do pai do objeto DPC. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

A estrutura WDF_DPC_CONFIG é usada como entrada para WdfDpcCreate.

Para inicializar uma estrutura de WDF_DPC_CONFIG , o driver deve primeiro chamar WDF_DPC_CONFIG_INIT e, em seguida, preencher os membros da estrutura que WDF_DPC_CONFIG_INIT não inicializa.

Definir AutomaticSerialization como TRUE não terá efeito se o escopo de sincronização do objeto de dispositivo pai estiver definido como WdfSynchronizationScopeNone.

Definir AutomaticSerialization como TRUE fará com que WdfDpcCreate falhe se o nível de execução do objeto de dispositivo pai estiver definido como WdfExecutionLevelPassive.

Para obter mais informações sobre a AutomaticSerialization e a sincronização de funções de retorno de chamada do driver, consulte Técnicas de sincronização para drivers de Framework-Based.

Para obter mais informações sobre como lidar com interrupções em drivers baseados em estrutura, consulte Tratamento de interrupções de hardware.