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


Метод IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval (wudfddi.h)

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

Функция обратного вызова событий на основе UMDF OnRemoteInterfaceRemoval уведомляет драйвер о том, что он не может использовать интерфейс устройства, так как интерфейс был удален.

Синтаксис

void OnRemoteInterfaceRemoval(
  [in] IWDFRemoteInterface *pWdfRemoteInterface
);

Параметры

[in] pWdfRemoteInterface

Указатель на интерфейс IWDFRemoteInterface объекта удаленного интерфейса, представляющего интерфейс устройства. Драйвер получает этот указатель при вызове IWDFDevice2::CreateRemoteInterface.

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

Никакой

Замечания

Функция обратного вызова событий драйвера OnRemoteInterfaceRemoval должна выполнять все задачи, связанные с драйвером, для удаления интерфейса устройства. Кроме того, обратный вызов должен удалить объект удаленного интерфейса, который IWDFDevice2::CreateRemoteInterface создали и вызовите функцию выпуска интерфейса, если она ранее вызвала функцию AddRef интерфейса.

Если драйвер не предоставляет эту функцию обратного вызова, платформа удаляет объект удаленного интерфейса, который IWDFDevice2::CreateRemoteInterface.

Дополнительные сведения о функции обратного вызова событий драйвера OnRemoteInterfaceRemoval см. в использовании интерфейсов устройств в драйверах на основе UMDF.

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.9
заголовка wudfddi.h (include Wudfddi.h)

См. также

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval