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

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

  • Статья

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

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

Синтаксис

HRESULT CloseForQueryRemove();

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

Метод CloseForQueryRemove всегда возвращает S_OK.

Комментарии

Если драйвер предоставляет функцию обратного вызова IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove , функция обратного вызова должна вызвать CloseForQueryRemove , если она возвращает значение TRUE , чтобы указать, что устройство можно удалить.

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

После вызова closeForQueryRemove драйвер не может отправлять запросы ввода-вывода целевому объекту ввода-вывода, пока не вызовет IWDFRemoteTarget::Reopen.

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

Примеры

В следующем примере кода показана функция обратного вызова IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove , которая вызывает CloseForQueryRemove.

BOOL
STDMETHODCALLTYPE
CMyRemoteTarget::OnRemoteTargetQueryRemove(
    __in IWDFRemoteTarget  *FxTarget
    )
{
    //
    // Here, do any driver-specific actions that your driver requires
    // to stop sending I/O requests to the I/O target.
    //
...
    //
    // Close the target.
    //
    FxTarget->CloseForQueryRemove();

    //
    // Return TRUE if you want to allow removal of the device.
    //
    return TRUE;
}

Требования

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

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

IWDFRemoteTarget

IWDFRemoteTarget::Close