estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY (wdfio.h)

[Solo se aplica a KMDF]

La estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY contiene información proporcionada por el controlador que usa el marco para habilitar el progreso hacia delante garantizado para una cola de E/S.

Sintaxis

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;

Miembros

Size

Longitud, en bytes, de esta estructura.

TotalForwardProgressRequests

Número de objetos de solicitud que el marco intentará reservar para su uso en situaciones de poca memoria. Este número debe ser mayor que cero.

ForwardProgressReservedPolicy

Valor WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY con tipo que especifica cómo asignará el marco objetos de solicitud durante situaciones de poca memoria.

ForwardProgressReservePolicySettings

Estructura WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS que contiene valores adicionales específicos de la directiva que especifica el miembro ForwardProgressReservedPolicy . Este miembro debe ser NULL a menos que el controlador proporcione una función de devolución de llamada EvtIoWdmIrpForwardProgress .

EvtIoAllocateResourcesForReservedRequest

Puntero a la función de devolución de llamada EvtIoAllocateResourcesForReservedRequest específica de la cola del controlador o NULL.

EvtIoAllocateRequestResources

Puntero a la función de devolución de llamada EvtIoAllocateRequestResources específica de la cola del controlador o NULL.

Comentarios

La estructura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY se usa como entrada para el método WdfIoQueueAssignForwardProgressPolicy .

Los controladores deben inicializar la estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY llamando a WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT o WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT antes de llamar a WdfIoQueueAssignForwardProgressPolicy.

Requisitos

Requisito Value
Versión mínima de KMDF 1,9
Encabezado wdfio.h (incluya Wdf.h)