Metodo IWDFObject::D eleteWdfObject (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]
Il metodo DeleteWdfObject elimina un oggetto Microsoft Windows Driver Frameworks (WDF) creato in precedenza.
Sintassi
HRESULT DeleteWdfObject();
Valore restituito
DeleteWdfObject restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) o uno degli altri codici di errore definiti in Winerror.h.
Commenti
Un driver non è in grado di eliminare alcuni oggetti WDF. Ad esempio, il driver non può eliminare un oggetto dispositivo framework perché il framework possiede e controlla gli oggetti dispositivo. Per altre informazioni sulla gerarchia degli oggetti WDF, vedere Gerarchia di oggetti Framework.
Il driver elimina in genere solo oggetti WDF creati e proprietari. Per altre informazioni sull'eliminazione di oggetti framework, vedere Gestione della durata degli oggetti.
Tuttavia, quando un oggetto padre viene eliminato, tutti gli oggetti figlio vengono eliminati automaticamente. Ad esempio, se il driver denominato IWDFDevice::CreateIoQueue per creare un oggetto coda I/O appena creato diventa un elemento figlio dell'oggetto dispositivo. L'oggetto coda I/O viene quindi eliminato automaticamente quando l'oggetto dispositivo viene eliminato senza che il driver chiami in modo esplicito DeleteWdfObject.
Esempio
Per un esempio di codice di come usare il metodo DeleteWdfObject , vedere IWDFDevice::SetPnpState.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |