Funzione WdfWorkItemGetParentObject (wdfworkitem.h)

  • Articolo

[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)

Vedi anche

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate