Método IWDFDevice2::CreateRemoteTarget (wudfddi.h)
[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 |
|---|---|
|
Error en el intento del marco de trabajo de asignar memoria. |
|
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 |