WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT-Funktion (wdfio.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT-Funktion initialisiert die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Struktur eines Treibers.

Syntax

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_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_DEFAULT_INIT-Funktion nullt die angegebene WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur und legt ihr Element Size fest. Außerdem wird der TotalForwardProgressRequests-Member der Struktur auf den angegebenen Wert festgelegt und der ForwardProgressReservedPolicy-Member auf WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest 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.

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