Funzione WdfWorkItemGetParentObject (wdfworkitem.h)
[Si applica a KMDF e UMDF]
Il metodo WdfWorkItemGetParentObject restituisce l'oggetto framework a cui è associato un elemento di lavoro specificato.
Sintassi
WDFOBJECT WdfWorkItemGetParentObject(
[in] WDFWORKITEM WorkItem
);
Parametri
[in] WorkItem
Handle a un oggetto elemento di lavoro del framework ottenuto da una chiamata precedente a WdfWorkItemCreate.
Valore restituito
WdfWorkItemGetParentObject restituisce un handle all'oggetto framework specificato come membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES del driver quando il driver ha chiamato in precedenza WdfWorkItemCreate.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Per altre informazioni sugli elementi di lavoro, vedere Uso degli elementi di lavoro di Framework.
Esempio
L'esempio di codice seguente è una funzione di callback EvtWorkItem dal driver di esempio 1394 . L'esempio ottiene un oggetto dispositivo padre di un elemento di lavoro, chiama una routine definita dal driver per elaborare l'elemento di lavoro e quindi elimina l'oggetto elemento di lavoro.
VOID
t1394_BusResetRoutineWorkItem(
IN WDFWORKITEM WorkItem
)
{
WDFDEVICE Device = WdfWorkItemGetParentObject(WorkItem);
t1394_UpdateGenerationCount(Device);
WdfObjectDelete(WorkItem);
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfworkitem.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) |