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. Non vengono aggiunte nuove funzionalità 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, vedi Introduzione a UMDF.]
Il metodo DeleteWdfObject elimina un oggetto WDF (Microsoft Windows Driver Framework) 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.
Osservazioni
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 Framework Object Hierarchy.
Il driver elimina in genere solo gli oggetti WDF creati e di proprietà. Per altre informazioni sull'eliminazione di oggetti framework, vedere Gestione della durata degli oggetti.
Tuttavia, quando viene eliminato un oggetto padre, tutti gli oggetti figlio vengono eliminati automaticamente. Ad esempio, se il driver denominato IWDFDevice::CreateIoQueue per creare un oggetto coda di I/O, la coda di I/O appena creata 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 esplicitamente DeleteWdfObject.
Esempi
Per un esempio di codice su come usare il metodo DeleteWdfObject, vedere IWDFDevice::SetPnpState.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |