WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT-Funktion (wdfio.h)

Artikel
03/01/2024

[Gilt nur für KMDF]

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT-Funktion initialisiert die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Struktur eines Treibers.

Syntax

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

Parameter

[out] Policy

Ein Zeiger auf die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Struktur des Treibers.

[in] TotalForwardProgressRequests

Die Anzahl der Anforderungsobjekte, die das Framework für die Verwendung in Situationen mit wenig Arbeitsspeicher reservieren möchte. Dieser Wert muss größer null sein.

Rückgabewert

Keine

Bemerkungen

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT-Funktion nullt die angegebene WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur und legt ihr Element Size fest. Außerdem wird das ForwardProgressReservedPolicy-Element auf WdfIoForwardProgressReservedPolicyUseExamine festgelegt.

Beispiele

Im folgenden Codebeispiel wird eine WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur initialisiert und dann WdfIoQueueAssignForwardProgressPolicy aufgerufen. Im Beispiel gibt der Treiber an, dass das Framework 10 Anforderungsobjekte für Situationen mit wenig Arbeitsspeicher zuordnen und reservieren soll, und dass das Framework eine der reservierten Anforderungen in Situationen mit wenig Arbeitsspeicher nur verwenden soll, wenn es sich bei der E/A-Anforderung um einen Pagingvorgang handelt.

#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
    );