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 per un oggetto elemento di lavoro del framework ottenuto da una chiamata precedente a WdfWorkItemCreare.
Valore restituito
WdfWorkItemGetParentObject restituisce un handle all'oggetto framework specificato dal driver come membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES del driver quando il driver precedentemente chiamato WdfWorkItemCreate.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni
Per altre informazioni sugli elementi di lavoro, vedere Using Framework Work Items.
Esempi
L'esempio di codice seguente è un EvtWorkItem funzione di callback dal driver di esempio 139 4. Nell'esempio viene ottenuto l'oggetto dispositivo padre di un elemento di lavoro, viene chiamata una routine definita dal driver per elaborare l'elemento di lavoro e quindi viene eliminato l'oggetto elemento di lavoro.
VOID
t1394_BusResetRoutineWorkItem(
IN WDFWORKITEM WorkItem
)
{
WDFDEVICE Device = WdfWorkItemGetParentObject(WorkItem);
t1394_UpdateGenerationCount(Device);
WdfObjectDelete(WorkItem);
}
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfworkitem.h (include Wdf.h) |
| libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |