Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[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 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 al IRemoteTargetCallbackRemoval interfaz del controlador, si el controlador admite esa interfaz. Este parámetro es opcional y se puede 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 al IWDFRemoteTarget interfaz 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 podría devolver uno de los otros valores que contiene Winerror.h.
Observaciones
Después de llamar al controlador 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 de IWDFDevice2::CreateRemoteInterface y IWDFRemoteTarget::OpenFileByName.
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.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
| DLL de | WUDFx.dll |