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)

Consulte también

FILE_OBJECT