Функция SpbRequestComplete (spbcx.h)

Статья
02/29/2024

Метод SpbRequestComplete завершает запрос ввода-вывода и предоставляет состояние завершения.

Синтаксис

void SpbRequestComplete(
  [in] SPBREQUEST Request,
  [in] NTSTATUS   CompletionStatus
);

Параметры

[in] Request

Дескриптор SPBREQUEST для запроса ввода-вывода для завершения. Драйвер контроллера SPB ранее получал этот дескриптор через одну из зарегистрированных функций обратного вызова события.

[in] CompletionStatus

Значение NTSTATUS, представляющее состояние завершения запроса. Допустимые значения состояния включают, помимо прочего, следующие:

STATUS_SUCCESS

Запрос ввода-вывода успешно завершен.

STATUS_CANCELLED

Запрос ввода-вывода отменяется.

STATUS_UNSUCCESSFUL

Драйвер обнаружил ошибку при обработке запроса ввода-вывода.

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

None

Remarks

Драйвер контроллера вызывает этот метод для выполнения запроса ввода-вывода, полученного ранее во время одного из следующих обратных вызовов:

EvtSpbControllerIoOther EvtSpbControllerIoRead EvtSpbControllerIoSequence EvtSpbControllerIoWrite Call SpbRequestComplete вместо метода WdfRequestComplete для выполнения запросов ввода-вывода, полученных функциями обратного вызова из предыдущего списка.

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

Вызов SpbRequestComplete представляет собой заключительный этап обработки запроса ввода-вывода. При возврате этого метода значение дескриптора запроса становится недействительным.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	spbcx.h
Библиотека	Spbcxstubs.lib
IRQL	<= DISPATCH_LEVEL