Partilhar via

estrutura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY (wdfio.h)

  • Artigo

[Aplica-se somente ao KMDF]

A estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY contém informações fornecidas pelo driver que a estrutura usa para habilitar progresso de encaminhamento garantido para uma fila de E/S.

Sintaxe

typedef struct _WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY {
  ULONG                                              Size;
  ULONG                                              TotalForwardProgressRequests;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY            ForwardProgressReservedPolicy;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS   ForwardProgressReservePolicySettings;
  PFN_WDF_IO_ALLOCATE_RESOURCES_FOR_RESERVED_REQUEST EvtIoAllocateResourcesForReservedRequest;
  PFN_WDF_IO_ALLOCATE_REQUEST_RESOURCES              EvtIoAllocateRequestResources;
} WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, *PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY;

Membros

Size

O comprimento, em bytes, dessa estrutura.

TotalForwardProgressRequests

O número de objetos de solicitação que a estrutura tentará reservar para uso em situações de memória baixa. Esse número deve ser maior que zero.

ForwardProgressReservedPolicy

Um valor WDF_IO_FORWARD_PROGRESS_RESERVED_POLICYdigitado que especifica como a estrutura alocará objetos de solicitação durante situações de baixa memória.

ForwardProgressReservePolicySettings

Uma estrutura WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS que contém valores adicionais específicos à política especificada pelo membro ForwardProgressReservedPolicy. Esse membro deve ser NULL, a menos que o driver forneça uma função de retorno de chamada EvtIoWdmIrpForForwardProgress.

EvtIoAllocateResourcesForReservedRequest

Um ponteiro para a função de retorno de chamada EvtIoAllocateResourcesForReservedRequest do driver ou NULL.

EvtIoAllocateRequestResources

Um ponteiro para a função de retorno de chamada EvtIoAllocateRequestResources específica da fila do driver ou NULL.

Observações

A estrutura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY é usada como entrada para o método WdfIoQueueAssignForwardProgressPolicy.

Os drivers devem inicializar a estrutura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY chamando WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INITou WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT antes de chamar WdfIoQueueAssignForwardProgressPolicy.

Requisitos

Requisito Valor
versão mínima do KMDF 1.9
cabeçalho wdfio.h (inclua Wdf.h)