Метод IWDFRemoteTarget::Close (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Метод Close закрывает удаленный целевой объект ввода-вывода.
Синтаксис
HRESULT Close();
Возвращаемое значение
Метод Close всегда возвращает S_OK.
Комментарии
Если драйвер предоставляет функцию обратного вызова IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete , функция обратного вызова должна вызвать Close.
Метод Close завершает или отменяет все запросы ввода-вывода, отправленные драйвером в целевой объект ввода-вывода.
После вызова close драйвер не может отправлять запросы ввода-вывода целевому объекту ввода-вывода.
Дополнительные сведения о методе Close см. в разделе Управление состоянием общего целевого объекта ввода-вывода в UMDF.
Примеры
В следующем примере кода показана функция обратного вызова IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete, которая вызывает Close.
VOID
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetRemoveComplete(
__in IWDFRemoteTarget *FxTarget
)
{
//
// Here, do any driver-specific actions that your driver requires
// to close the remote I/O target.
//
...
//
// Close the target.
//
FxTarget->Close();
}
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1,9 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |
| DLL | WUDFx.dll |