Função WdfFileObjectWdmGetFileObject (wdffileobject.h)
[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) |