Метод IWDFIoRequest::SetCompletionCallback (wudfddi.h)
[Предупреждение: 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