WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur (wdfio.h)

[Gilt nur für KMDF]

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur enthält vom Treiber bereitgestellte Informationen, die das Framework verwendet, um den garantierten Vorwärtsfortschritt für eine E/A-Warteschlange zu ermöglichen.

Syntax

typedef struct _WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY {
  ULONG                                              Size;
  ULONG                                              TotalForwardProgressRequests;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY            ForwardProgressReservedPolicy;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS   ForwardProgressReservePolicySettings;
  PFN_WDF_IO_ALLOCATE_RESOURCES_FOR_RESERVED_REQUEST EvtIoAllocateResourcesForReservedRequest;
  PFN_WDF_IO_ALLOCATE_REQUEST_RESOURCES              EvtIoAllocateRequestResources;
} WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, *PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY;

Member

Size

Die Länge dieser Struktur in Bytes.

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.

ForwardProgressReservedPolicy

Ein WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY typisierter Wert, der angibt, wie das Framework Anforderungsobjekte in Situationen mit wenig Arbeitsspeicher zuordnet.

ForwardProgressReservePolicySettings

Eine WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS-Struktur , die zusätzliche Werte enthält, die für die Richtlinie spezifisch sind, die vom ForwardProgressReservedPolicy-Member angegeben wird. Dieser Member sollte NULL sein, es sei denn, der Treiber stellt eine EvtIoWdmIrpForForForProgress-Rückruffunktion bereit.

EvtIoAllocateResourcesForReservedRequest

Ein Zeiger auf die warteschlangenspezifische EvtIoAllocateResourcesForReservedRequest-Rückruffunktion des Treibers ( NULL).

EvtIoAllocateRequestResources

Ein Zeiger auf die warteschlangenspezifische EvtIoAllocateRequestResources-Rückruffunktion des Treibers oder NULL.

Hinweise

Die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur wird als Eingabe für die WdfIoQueueAssignForwardProgressPolicy-Methode verwendet.

Treiber müssen die WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY-Struktur initialisieren, indem sie WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT oder WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT aufrufen, bevor sie WdfIoQueueAssignForwardProgressPolicy aufrufen.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.9
Kopfzeile	wdfio.h (einschließen von Wdf.h)