Метод IWDFRemoteTarget::Close (wudfddi.h)

Статья
02/07/2025

[ предупреждение: 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::OnRemoteTargetRemov eCompleteComplete, функция обратного вызова должна вызывать Close.

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

После вызова драйвера Закрытьдрайвер не может отправлять запросы ввода-вывода в целевой объект ввода-вывода.

Дополнительные сведения о методе Close см. в управлении состоянием общего объекта ввода-вывода вUMDF.

Примеры

В следующем примере кода показана функция обратного вызова IRemoteTargetCallbackRemoval::OnRemoteTargetRemov eCompleteComplete, которая вызывает 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 (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFRemoteTarget

IWDFRemoteTarget::CloseForQueryRemove

Поделиться через