Функция WdfIoQueueRetrieveNextRequest (wdfio.h)

[Применимо к KMDF и UMDF]

Метод WdfIoQueueRetrieveNextRequest извлекает следующий доступный запрос ввода-вывода из указанной очереди ввода-вывода.

Синтаксис

NTSTATUS WdfIoQueueRetrieveNextRequest(
  [in]  WDFQUEUE   Queue,
  [out] WDFREQUEST *OutRequest
);

Параметры

[in] Queue

Дескриптор объекта очереди платформы.

[out] OutRequest

Указатель на расположение, которое получает дескриптор объекту запроса платформы. Если очередь пуста или получен последний запрос, этот параметр получает NULL.

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

WdfIoQueueRetrieveNextRequest возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть одно из следующих значений:

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Если драйвер настраивает очередь ввода-вывода для ручной отправки запросов ввода-вывода, драйвер обычно вызывает WdfIoQueueRetrieveNextRequest для получения запросов из очереди. Драйвер, настроив очередь ввода-вывода для последовательной отправки, также может вызывать WdfIoQueueRetrieveNextRequest. Дополнительные сведения об использовании WdfIoQueueRetrieveNextRequest с методами ручной или последовательной отправки см. в методах отправки запросов ввода-вывода.

После вызова WdfIoQueueRetrieveNextRequest для получения запроса ввода-вывода драйвер принадлежит запросу и должен обрабатывать запрос ввода-вывода каким-то образом.

Дополнительные сведения о методе WdfIoQueueRetrieveNextRequest см. в управлении очередями ввода-вывода.

Примеры

Следующий пример кода получает дескриптор для следующего объекта запроса, содержащегося в очереди ввода-вывода устройства.

NTSTATUS  status;
WDFREQUEST  request;

status = WdfIoQueueRetrieveNextRequest(
                                       pDeviceContext->ReadQueue,
                                       &request
                                       );

Требования

См. также

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveRequestByFileObject