función WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT (wdfio.h)

Artículo
02/29/2024

[Solo se aplica a KMDF]

La función WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT inicializa la estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY de un controlador.

Sintaxis

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
  [in]  ULONG                                 TotalForwardProgressRequests
);

Parámetros

[out] Policy

Puntero a la estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY del controlador.

[in] 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.

Valor devuelto

None

Observaciones

La función WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT cero la estructura WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY especificada y establece su miembro Size . También establece el miembro ForwardProgressReservedPolicy en WdfIoForwardProgressReservedPolicyUseExamine.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY y, a continuación, se llama a WdfIoQueueAssignForwardProgressPolicy. En el ejemplo, el controlador especifica que el marco debe asignar y reservar 10 objetos de solicitud para situaciones de poca memoria y que el marco debe usar una de las solicitudes reservadas durante situaciones de poca memoria solo si la solicitud de E/S es una operación de paginación.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );