Funzione WdfObjectCreate (wdfobject.h)
[Si applica a KMDF e UMDF]
Il metodo WdfObjectCreate crea un oggetto framework generale.
Sintassi
NTSTATUS WdfObjectCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFOBJECT *Object
);
Parametri
[in, optional] Attributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES contenente attributi forniti dal driver per il nuovo oggetto. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[out] Object
Puntatore a una posizione che riceve un handle per il nuovo oggetto framework.
Valore restituito
WdfObjectCreate restituisce STATUS_SUCCESS se l'operazione ha esito positivo. Per un elenco di valori restituiti aggiuntivi, vedere Errori di creazione di oggetti Framework.
Questo metodo potrebbe restituire anche altri valori NTSTATUS.
Commenti
Per impostazione predefinita, il nuovo padre dell'oggetto framework generale è l'oggetto driver del framework creato dal metodo WdfDriverCreate . È possibile usare il membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES per specificare un elemento padre diverso. Il framework elimina l'oggetto generale quando elimina l'oggetto padre. Se il driver non modifica l'elemento padre predefinito, il driver deve eliminare l'oggetto generale al termine dell'uso dell'oggetto; in caso contrario, l'oggetto rimarrà fino a quando il gestore di I/O scarica il driver.
Per altre informazioni sul metodo WdfObjectCreate , vedere Uso di oggetti General Framework.
Per altre informazioni sulle regole di pulizia per una gerarchia di oggetti framework, vedere Ciclo di vita dell'oggetto Framework.
Esempio
Nell'esempio di codice seguente viene inizializzata una struttura WDF_OBJECT_ATTRIBUTES e viene creato un oggetto framework generale.
WDF_OBJECT_ATTRIBUTES Attributes;
WDFOBJECT Object;
WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
&Attributes,
&Object
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfobject.h (includere Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |