Método IWDFDevice2::CreateRemoteTarget (wudfddi.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con UMDF.

El método CreateRemoteTarget crea un objeto de destino remoto que representa un destino de E/S remoto.

Sintaxis

HRESULT CreateRemoteTarget(
  [in, optional] IUnknown         *pCallbackInterface,
  [in, optional] IWDFObject       *pParentObject,
  [out]          IWDFRemoteTarget **ppRemoteTarget
);

Parámetros

[in, optional] pCallbackInterface

Puntero a una interfaz de devolución de llamada opcional proporcionada por el controlador. El método IUnknown::QueryInterface de esta interfaz debe devolver un puntero a la interfaz IRemoteTargetCallbackRemoval del controlador, si el controlador admite esa interfaz. Este parámetro es opcional y puede ser NULL.

[in, optional] pParentObject

Puntero a un objeto de marco. Si el controlador proporciona este puntero opcional, el objeto especificado se convierte en el elemento primario del nuevo objeto de destino remoto. Si este parámetro es NULL, el objeto de dispositivo que proporciona la interfaz IWDFDevice2 se convierte en el elemento primario. El marco eliminará el objeto de destino remoto cuando elimine el objeto primario.

[out] ppRemoteTarget

Puntero a una ubicación que recibe un puntero a la interfaz IWDFRemoteTarget del nuevo objeto de destino remoto.

Valor devuelto

CreateRemoteTarget devuelve S_OK si la operación se realiza correctamente. De lo contrario, el método podría devolver el siguiente valor:

Código devuelto Descripción
E_OUTOFMEMORY
 Error en el intento del marco de trabajo de asignar memoria.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)
 El parámetro pParentObject no especificó el objeto de dispositivo que proporciona la interfaz IWDFDevice2 o un objeto cuya cadena de elementos primarios conduce a ese objeto.
 

Este método puede devolver uno de los otros valores que contiene Winerror.h.

Comentarios

Una vez que el controlador haya llamado a CreateRemoteTarget, el controlador puede abrir el destino remoto llamando a IWDFRemoteTarget::OpenRemoteInterface (para abrir una interfaz de dispositivo) o IWDFRemoteTarget::OpenFileByName (para abrir un archivo).

Si el controlador usa el parámetro pParentObject para especificar un objeto primario, el objeto primario puede ser el objeto de dispositivo que proporciona la interfaz IWDFDevice2 , o puede ser cualquier objeto cuya cadena de elementos primarios conduce a ese objeto de dispositivo. El marco eliminará el objeto de destino remoto cuando (o el controlador) elimine el objeto de dispositivo.

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

Ejemplos

Para obtener ejemplos de código que usan CreateRemoteTarget, vea los ejemplos de código en IWDFDevice2::CreateRemoteInterface e IWDFRemoteTarget::OpenFileByName.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1,9
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface