Función WdfIoTargetWdmGetTargetFileObject (wdfiotarget.h)
[Solo se aplica a KMDF]
El método WdfIoTargetWdmGetTargetFileObject devuelve un puntero al objeto de archivo modelo de controlador de Windows (WDM) asociado a un destino de E/S remoto especificado.
Sintaxis
PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
[in] WDFIOTARGET IoTarget
);
Parámetros
[in] IoTarget
Identificador de un objeto de destino de E/S remoto. Este identificador se obtuvo de una llamada anterior a WdfIoTargetCreate.
Valor devuelto
WdfIoTargetWdmGetTargetFileObject devuelve un puntero a una estructura de FILE_OBJECT WDM.
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 WdfIoTargetWdmGetTargetFileObject es válido hasta que el controlador llama a WdfIoTargetClose o WdfIoTargetCloseForQueryRemove, o hasta que se elimine el objeto de destino de E/S remoto. Si el controlador proporciona una función EvtCleanupCall back para el objeto de destino de E/S remoto y, si el objeto se elimina antes de que se cierre el destino de E/S remoto, el puntero es válido hasta que se devuelve la función EvtCleanupCallback.
Si el controlador intenta acceder al objeto de dispositivo WDM después de quitarlo, el controlador puede hacer que el sistema se bloquee. El toastmon muestra cómo el controlador puede proporcionar un EvtIoTargetQueryRemove función de devolución de llamada para que se notifique si se quita el destino de E/S.
Para obtener más información sobre WdfIoTargetWdmGetTargetFileObject, vea Obtener información sobre un destino de E/S general.
Para obtener más información sobre los destinos de E/S, consulte Uso de destinos de E/S.
Ejemplos
En el ejemplo de código siguiente se obtiene un puntero al objeto de archivo WDM asociado a un destino de E/S remoto.
PFILE_OBJECT pfileObject;
pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfiotarget.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) |