Метод IWDFObject::D eleteWdfObject (wudfddi.h)

  • Статья

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

Метод DeleteWdfObject удаляет ранее созданный объект Microsoft Windows Driver Frameworks (WDF).

Синтаксис

HRESULT DeleteWdfObject();

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

DeleteWdfObject возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) или один из других кодов ошибок, определенных в Winerror.h.

Комментарии

Драйвер не может удалить некоторые объекты WDF. Например, драйвер не может удалить объект устройства платформы , так как платформа владеет объектами устройств и управляет ими. Дополнительные сведения об иерархии объектов WDF см. в разделе Framework Object Hierarchy.

Драйвер обычно удаляет только создаваемые и принадлежащие ему объекты WDF. Дополнительные сведения об удалении объектов платформы см. в разделе Управление временем существования объектов.

Однако при удалении родительского объекта все дочерние объекты автоматически удаляются. Например, если драйвер с именем IWDFDevice::CreateIoQueue создает объект очереди ввода-вывода, созданная очередь ввода-вывода становится дочерней для объекта устройства. Затем объект очереди ввода-вывода автоматически удаляется при удалении объекта устройства без явного вызова Драйвером DeleteWdfObject.

Примеры

Пример кода использования метода DeleteWdfObject см. в разделе IWDFDevice::SetPnpState.

Требования

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

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

IWDFDevice::CreateIoQueue

IWDFObject