структура WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY (wdfio.h)

  • Статья

[Относится только к KMDF]

Структура WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY содержит предоставленные драйвером сведения, которые платформа использует для обеспечения гарантированного прогресса в очереди ввода-вывода.

Синтаксис

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;

Члены

Size

Длина этой структуры в байтах.

TotalForwardProgressRequests

Количество объектов запроса, которые платформа попытается зарезервировать для использования в ситуациях нехватки памяти. Это число должно быть больше нуля.

ForwardProgressReservedPolicy

WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY типизированное значение, указывающее, как платформа будет выделять объекты запроса при нехватке памяти.

ForwardProgressReservePolicySettings

Структура WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS , содержащая дополнительные значения, относящиеся к политике, которую задает член ForwardProgressReservedPolicy . Этот элемент должен иметь значение NULL , если драйвер не предоставляет функцию обратного вызова EvtIoWdmIrpForForwardProgress .

EvtIoAllocateResourcesForReservedRequest

Указатель на функцию обратного вызова EvtIoAllocateResourcesForReservedRequest для конкретной очереди драйвера или NULL.

EvtIoAllocateRequestResources

Указатель на функцию обратного вызова EvtIoAllocateRequestResources для конкретной очереди драйвера или NULL.

Комментарии

Структура WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY используется в качестве входных данных для метода WdfIoQueueAssignForwardProgressPolicy .

Драйверы должны инициализировать структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY путем вызова WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT, WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT или WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT перед вызовом WdfIoQueueAssignForwardProgressPolicy.

Требования

Требование Значение
Минимальная версия KMDF 1,9
Верхняя часть wdfio.h (включая Wdf.h)