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

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

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

Синтаксис

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_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_DEFAULT_INIT обнуляет указанную структуру WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY и задает ее член Size . Он также задает для элемента Структуры TotalForwardProgressRequests указанное значение и для элемента ForwardProgressReservedPolicy значение WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest.

Примеры

В следующем примере кода инициализируется структура 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_DEFAULT_INIT(
                                                  &queueForwardProgressPolicy,
                                                  MAX_RESERVED_REQUESTS
                                                  );
status = WdfIoQueueAssignForwardProgressPolicy(
                                               readQueue,
                                               &queueForwardProgressPolicy
                                               );

Требования

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

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT

WdfIoQueueAssignForwardProgressPolicy