WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT-Funktion (wdfio.h)

Artikel
03/22/2025

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

Die 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 geringem Arbeitsspeicher reserviert. Diese Zahl muss größer als Null sein.

Rückgabewert

Nichts

Bemerkungen

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT-Funktion stellt die angegebene WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Struktur null und legt dessen Size-Element fest. Außerdem wird das ForwardProgressReservedPolicy Member auf WdfIoForwardProgressReservedPolicyUseExaminefestgelegt.

Beispiele

Im folgenden Codebeispiel wird eine WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Struktur initialisiert und anschließend WdfIoQueueAssignForwardProgressPolicyaufgerufen. Im Beispiel gibt der Treiber an, dass das Framework 10 Anforderungsobjekte für Situationen mit geringem Arbeitsspeicher zuordnen und reservieren soll und dass das Framework eine der reservierten Anforderungen nur in Situationen mit geringem Arbeitsspeicher verwenden sollte, wenn die E/A-Anforderung ein Auslagerungsvorgang ist.

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