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


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

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

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

Синтаксис

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
  [in]  ULONG                                 TotalForwardProgressRequests
);

Параметры

[out] Policy

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

[in] TotalForwardProgressRequests

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

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

None

Remarks

Функция WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT обнуляет указанную структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY и задает ее член Size . Он также задает для члена ForwardProgressReservedPolicy значение WdfIoForwardProgressReservedPolicyUseExamine.

Примеры

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

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT(
    &queueForwardProgressPolicy,
    MAX_RESERVED_REQUESTS
    );
status = WdfIoQueueAssignForwardProgressPolicy(
    readQueue,
    &queueForwardProgressPolicy
    );

Требования

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

См. также раздел

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT

WdfIoQueueAssignForwardProgressPolicy