Função WdfWorkItemGetParentObject (wdfworkitem.h)

[Aplica-se a KMDF e UMDF]

O método WdfWorkItemGetParentObject retorna o objeto de estrutura ao qual um item de trabalho especificado está associado.

Sintaxe

WDFOBJECT WdfWorkItemGetParentObject(
  [in] WDFWORKITEM WorkItem
);

Parâmetros

[in] WorkItem

Um identificador para um objeto de item de trabalho de estrutura obtido de uma chamada anterior para WdfWorkItemCreate.

Retornar valor

WdfWorkItemGetParentObject retorna um identificador para o objeto de estrutura especificado pelo driver como o membro ParentObject da estrutura de WDF_OBJECT_ATTRIBUTES do driver quando o driver anteriormente chamado WdfWorkItemCreate.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Para obter mais informações sobre itens de trabalho, consulte Usando itens de trabalho da estrutura.

Exemplos

O exemplo de código a seguir é uma função de retorno de chamada EvtWorkItem do driver de exemplo 1394 . O exemplo obtém o objeto de dispositivo pai de um item de trabalho, chama uma rotina definida pelo driver para processar o item de trabalho e exclui o objeto de item de trabalho.

VOID
t1394_BusResetRoutineWorkItem(
    IN WDFWORKITEM  WorkItem
)
{
    WDFDEVICE  Device = WdfWorkItemGetParentObject(WorkItem);

    t1394_UpdateGenerationCount(Device);

    WdfObjectDelete(WorkItem);
}

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfworkitem.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_OBJECT_ATTRIBUTES

WdfWorkItemCreate