Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[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 de 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.
Observaciones
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 Framework File Objects.
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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdffileobject.h (incluya Wdf.h) |
| Biblioteca | 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) |