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

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con 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.

Comentarios

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.

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 Administración de 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 el objeto de dispositivo se elimina sin el controlador que llama explícitamente a DeleteWdfObject.

Ejemplos

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

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFDevice::CreateIoQueue

IWDFObject