estrutura WDF_WORKITEM_CONFIG (wdfworkitem.h)

[Aplica-se a KMDF e UMDF]

A estrutura WDF_WORKITEM_CONFIG contém informações associadas a um item de trabalho.

Sintaxe

typedef struct _WDF_WORKITEM_CONFIG {
  ULONG            Size;
  PFN_WDF_WORKITEM EvtWorkItemFunc;
  BOOLEAN          AutomaticSerialization;
} WDF_WORKITEM_CONFIG, *PWDF_WORKITEM_CONFIG;

Membros

Size

O tamanho, em bytes, dessa estrutura WDF_WORKITEM_CONFIG .

EvtWorkItemFunc

O endereço de uma função de retorno de chamada de evento EvtWorkItem .

AutomaticSerialization

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

Comentários

O driver deve inicializar a estrutura de WDF_WORKITEM_CONFIG chamando WDF_WORKITEM_CONFIG_INIT. Em seguida, o driver pode passar a estrutura para o método WdfWorkItemCreate como um parâmetro de entrada.

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

Se AutomaticSerialization for TRUE, o nível de execução do objeto pai deverá ser 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.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfworkitem.h (inclua Wdf.h)

Confira também

EvtWorkItem

WDF_WORKITEM_CONFIG_INIT

WdfWorkItemCreate