Método IWDFObject::D eleteWdfObject (wudfddi.h)

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]

El método DeleteWdfObject elimina un objeto microsoft Windows Driver Frameworks (WDF) creado anteriormente.

Sintaxis

HRESULT DeleteWdfObject();

Valor devuelto

DeleteWdfObject devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) o uno de los otros códigos de error definidos en Winerror.h.

Observaciones

Un controlador no puede eliminar algunos objetos WDF. Por ejemplo, el controlador no puede eliminar un objeto de dispositivo de marco porque el marco posee y controla los objetos de dispositivo. Para obtener más información sobre la jerarquía de objetos WDF, vea Jerarquía de objetos de Marco de trabajo.

Normalmente, el controlador elimina solo los objetos WDF que crea y posee. Para obtener más información sobre cómo eliminar objetos de marco, vea Administrar la duración de los objetos.

Sin embargo, cuando se elimina un objeto primario, todos los objetos secundarios se eliminan automáticamente. Por ejemplo, si el controlador llamado IWDFDevice::CreateIoQueue para crear un objeto de cola de E/S, la cola de E/S recién creada se convierte en un elemento secundario del objeto de dispositivo. El objeto de cola de E/S se elimina automáticamente cuando se elimina el objeto de dispositivo sin que el controlador llame explícitamente a DeleteWdfObject.

Ejemplos

Para obtener un ejemplo de código de cómo usar el método DeleteWdfObject de, vea IWDFDevice::SetPnpState.

Requisitos

Consulte también

IWDFDevice::CreateIoQueue

IWDFObject