функция WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT (wdfio.h)

Статья
03/22/2025

[Применимо только к KMDF]

Функция WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT инициализирует структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY драйвера.

Синтаксис

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY   Policy,
  [in]  ULONG                                   TotalForwardProgressRequests,
  [in]  PFN_WDF_IO_WDM_IRP_FOR_FORWARD_PROGRESS EvtIoWdmIrpForForwardProgress
);

Параметры

[out] Policy

Указатель на структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY драйвера.

[in] TotalForwardProgressRequests

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

[in] EvtIoWdmIrpForForwardProgress

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

Возвращаемое значение

Нет

Замечания

Функция WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT ноль указанной структуры WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY и задает его член размера. Он также задает структуры TotalForwardProgressRequests иForwardProgressReservePolicySettings.Policy.ExaminePolicy.EvtIoWdmIrpForwardProgress элементам, заданным значениям, и задает элемент ForwardProgressReservedPolicy для WdfIoForwardProgressReservedPolicyUseExamine.

Примеры

Следующий пример кода инициализирует структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, а затем вызывает WdfIoQueueAssignForwardProgressPolicy. В этом примере драйвер указывает, что платформа должна выделять и резервировать 10 объектов запросов для ситуаций с низкой памятью, и что платформа должна вызывать myIoForwardExamineIrpForwardProgress функцию обратного вызова перед использованием одного из зарезервированных объектов запроса.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS,
    MyIoForwardExamineIrpForForwardProgress
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.9
Заголовок	wdfio.h (include Wdf.h)

См. также

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT

WdfIoQueueAssignForwardProgressPolicy

Поделиться через