Função WdfFileObjectWdmGetFileObject (wdffileobject.h)

[Aplica-se somente ao KMDF]

O método WdfFileObjectWdmGetFileObject retorna o objeto de arquivo WDM (Windows Driver Model) 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.

Valor de retorno

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.

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

Observações

O ponteiro que o método WdfFileObjectWdmGetFileObject retorna é válido até que o objeto de arquivo da 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 de Objetos de Arquivo da 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

Consulte também

FILE_OBJECT