Метод IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]
Функция обратного вызова события OnRemoteInterfaceRemoval драйвера на основе UMDF уведомляет драйвер о том, что он не может использовать интерфейс устройства , так как интерфейс был удален.
Синтаксис
void OnRemoteInterfaceRemoval(
[in] IWDFRemoteInterface *pWdfRemoteInterface
);
Параметры
[in] pWdfRemoteInterface
Указатель на интерфейс IWDFRemoteInterface объекта удаленного интерфейса, представляющего интерфейс устройства. Драйвер получает этот указатель при вызове IWDFDevice2::CreateRemoteInterface.
Возвращаемое значение
None
Remarks
Функция обратного вызова события OnRemoteInterfaceRemoval драйвера должна выполнять все задачи, связанные с драйвером, чтобы обработать удаление интерфейса устройства. Кроме того, обратный вызов должен удалить объект удаленного интерфейса, созданный IWDFDevice2::CreateRemoteInterface , и вызвать функцию Release интерфейса, если он ранее вызывал функцию AddRef интерфейса.
Если драйвер не предоставляет эту функцию обратного вызова, платформа удаляет объект удаленного интерфейса, созданный IWDFDevice2::CreateRemoteInterface .
Дополнительные сведения о функции обратного вызова события OnRemoteInterfaceRemoval для драйвера см. в статье Использование интерфейсов устройств в драйверах на основе UMDF.
Требования
Требование | Значение |
---|---|
Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
Целевая платформа | Персональный компьютер |
Минимальная версия UMDF | 1,9 |
Верхняя часть | wudfddi.h (включая Wudfddi.h) |
См. также раздел
IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival