función WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT (wdfio.h)

Artículo
02/27/2024

[Solo se aplica a KMDF]

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

Sintaxis

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_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_DEFAULT_INIT cero la estructura de WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY especificada y establece su miembro Size . También establece el miembro TotalForwardProgressRequests de la estructura en el valor especificado y establece el miembro ForwardProgressReservedPolicy en WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.

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.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

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