Compartilhar via

estrutura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY (wdfio.h)

  • Artigo

[Aplica-se somente ao KMDF]

A estrutura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY contém informações fornecidas pelo driver que a estrutura usa para habilitar o 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 insuficiente. Esse número deve ser maior que zero.

ForwardProgressReservedPolicy

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

ForwardProgressReservePolicySettings

Uma estrutura WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS que contém valores adicionais específicos para a 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 específica da fila do driver ou NULL.

EvtIoAllocateRequestResources

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

Comentários

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_INIT ou 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)