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

Elemente

Size

Die Länge dieser Struktur in Bytes.

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.

ForwardProgressReservedPolicy

Ein WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY-typed-Wert, der angibt, wie das Framework Anforderungsobjekte in Situationen mit geringem Arbeitsspeicher zuweist.

ForwardProgressReservePolicySettings

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

EvtIoAllocateResourcesForReservedRequest

Ein Zeiger auf die warteschlangenspezifische EvtIoAllocateResourcesForReservedRequest Rückruffunktion oder NULL-.

EvtIoAllocateRequestResources

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

Bemerkungen

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_INIToder WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT aufrufen, bevor sie WdfIoQueueAssignForwardProgressPolicyaufrufen.

Anforderungen