Función WdfFileObjectWdmGetFileObject (wdffileobject.h)
[Solo se aplica a KMDF]
El método WdfFileObjectWdmGetFileObject devuelve el objeto de archivo modelo de controlador de Windows (WDM) asociado a un objeto de archivo de marco especificado.
Sintaxis
PFILE_OBJECT WdfFileObjectWdmGetFileObject(
[in] WDFFILEOBJECT FileObject
);
Parámetros
[in] FileObject
Identificador de un objeto de archivo de marco.
Valor devuelto
WdfFileObjectWdmGetFileObject devuelve un puntero a la estructura FILE_OBJECT asociada al objeto de archivo de marco especificado o NULL si no hay ningún objeto de archivo WDM para el objeto de archivo de marco especificado.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
El puntero que devuelve el método WdfFileObjectWdmGetFileObject es válido hasta que se elimina el objeto de archivo de marco. Si el controlador proporciona una función EvtCleanupCallback para el objeto de archivo de marco, el puntero es válido hasta que se devuelve la función de devolución de llamada.
Para obtener más información sobre los objetos de archivo de marco, vea Objetos de archivo de marco.
Ejemplos
En el ejemplo de código siguiente se obtiene un identificador para el objeto de archivo WDM asociado a un objeto de archivo de marco especificado.
PFILE_OBJECT pReturnedFileObject;
pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdffileobject.h (incluir Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <=DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |