Função WdfFileObjectGetDevice (wdffileobject.h)

Artigo
03/22/2025

[Aplica-se a KMDF e UMDF]

O método WdfFileObjectGetDevice retorna o objeto de dispositivo da estrutura associado a um objeto de arquivo de estrutura especificado.

Sintaxe

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Parâmetros

[in] FileObject

Um identificador para um objeto de arquivo de estrutura.

Valor de retorno

WdfFileObjectGetDevice retorna um identificador para o objeto de dispositivo da estrutura associado ao objeto de arquivo de estrutura especificado.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre objetos de arquivo de estrutura, consulte de Objetos de Arquivo da Estrutura.

Exemplos

O exemplo de código a seguir mostra como um função de retorno de chamada EvtFileClose pode obter o objeto de dispositivo da estrutura associado a um objeto de arquivo de estrutura especificado.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdffileobject.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partilhar via