Метод IWDFIoRequest::SetCompletionCallback (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод SetCompletionCallback регистрирует интерфейс для метода OnCompletion , который платформа должна вызывать по завершении запроса ввода-вывода.

Синтаксис

void SetCompletionCallback(
  [in]           IRequestCallbackRequestCompletion *pCompletionCallback,
  [in, optional] void                              *pContext
);

Параметры

[in] pCompletionCallback

Указатель на интерфейс IRequestCallbackRequestCompletion , чей метод OnCompletion вызывается платформой после завершения запроса ввода-вывода. Начиная с версии 1.9 UMDF драйвер может указать ЗНАЧЕНИЕ NULL , чтобы отменить регистрацию ранее зарегистрированного метода OnCompletion .

[in, optional] pContext

Указатель на буфер, содержащий сведения о контексте, связанные с завершением запроса. Платформа передает эти сведения контекста в вызове метода IRequestCallbackRequestCompletion::OnCompletion . Этот параметр является необязательным и может иметь значение NULL.

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

None

Remarks

Если драйверу, переадресовывшему запросу ввода-вывода, требуется уведомление, когда драйвер нижнего уровня завершает запрос, драйвер может предоставить подпрограмму завершения и вызвать SetCompletionCallback , чтобы зарегистрировать интерфейс IRequestCallbackRequestCompletion для подпрограммы завершения. Платформа вызывает подпрограмму завершения после того, как драйвер нижнего уровня завершит запрос ввода-вывода.

Примеры

Пример кода использования метода SetCompletionCallback см. в разделе IWDFIoRequest::Send.

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

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

IRequestCallbackRequestCompletion

IRequestCallbackRequestCompletion::OnCompletion

IWDFIoRequest

IWDFIoRequest::Send