Compartir a través de


Método IWDFIoTarget::GetTargetFile (wudfddi.h)

Advertencia

UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.

El método GetTargetFile recupera el objeto de archivo de marco asociado al objeto de destino de E/S.

Sintaxis

void GetTargetFile(
  [out] IWDFFile **ppWdfFile
);

Parámetros

[out] ppWdfFile

Puntero a un búfer que recibe un puntero a la interfaz IWDFFile del objeto de archivo del destino de E/S.

Valor devuelto

Ninguno

Observaciones

Si un objeto de archivo de marco está asociado a un objeto de destino de E/S, el marco incluye el objeto de archivo con solicitudes de E/S que el controlador envía al objeto de destino de E/S.

Cuando un controlador da formato a una solicitud de E/S, un objeto de destino de E/S permite al controlador usar el mismo archivo con el que se inició la solicitud o un archivo nuevo.

El destino de E/S predeterminado no tiene ningún objeto de archivo, por lo que una llamada a GetTargetFile para el destino de E/S predeterminado recupera NULL.

Para obtener más información sobre los destinos de E/S, consulte Uso de destinos de E/S en umDF.

Ejemplos

Para obtener un ejemplo de código de cómo usar el método GetTargetFile, vea IWDFIoTarget::FormatRequestForWrite.

Requisitos

Requisito Valor
fin del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
de la plataforma de destino de Escritorio
versión mínima de UMDF 1.5
encabezado de wudfddi.h (incluya Wudfddi.h)
DLL de WUDFx.dll

Consulte también