Метод 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 (include Wudfddi.h) |
| DLL | WUDFx.dll |