Função WdfFileObjectWdmGetFileObject (wdffileobject.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfFileObjectWdmGetFileObject retorna o objeto de arquivo WDM (Modelo de Driver do Windows) associado a um objeto de arquivo de estrutura especificado.

Sintaxe

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Parâmetros

[in] FileObject

Um identificador para um objeto de arquivo de estrutura.

Retornar valor

WdfFileObjectWdmGetFileObject retorna um ponteiro para a estrutura FILE_OBJECT associada ao objeto de arquivo de estrutura especificado ou NULL se não houver nenhum objeto de arquivo WDM para o objeto de arquivo de estrutura especificado.

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

Comentários

O ponteiro que o método WdfFileObjectWdmGetFileObject retorna é válido até que o objeto de arquivo de estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de arquivo de estrutura, o ponteiro será válido até que a função de retorno de chamada retorne.

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

Exemplos

O exemplo de código a seguir obtém um identificador para o objeto de arquivo WDM associado a um objeto de arquivo de estrutura especificado.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdffileobject.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

FILE_OBJECT