Método IWDFRemoteTarget::OpenRemoteInterface (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 OpenRemoteInterface abre un interfaz de dispositivo para que el controlador pueda enviar solicitudes de E/S a ella.
Sintaxis
HRESULT OpenRemoteInterface(
[in] IWDFRemoteInterface *pRemoteInterface,
[in, optional] PCWSTR pszRelativeFileName,
[in] DWORD DesiredAccess,
[in, optional] PUMDF_IO_TARGET_OPEN_PARAMS pOpenParams
);
Parámetros
[in] pRemoteInterface
Puntero a una interfaz de IWDFRemoteInterface que el controlador obtuvo de una llamada anterior a IWDFDevice2::CreateRemoteInterface.
[in, optional] pszRelativeFileName
Puntero opcional a un autor de llamada proporcionado, cadena terminadanull que el marco anexa al nombre de vínculo simbólico de la interfaz del dispositivo.
[in] DesiredAccess
Máscara de bits que especifica el acceso deseado del autor de la llamada al archivo. Para obtener más información sobre este miembro, consulte el parámetro DesiredAccess de CreateFile en Windows SDK.
[in, optional] pOpenParams
Puntero a una estructura de UMDF_IO_TARGET_OPEN_PARAMS asignada por el autor de la llamada que contiene parámetros adicionales. Este parámetro es opcional y se puede NULL.
Valor devuelto
OpenRemoteInterface 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. |
Este método podría devolver uno de los otros valores que contiene Winerror.h.
El comprobador del marco notifica un error si el marco no puede abrir el archivo.
Observaciones
Después de IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival función de devolución de llamada recibe una notificación de que hay disponible una interfaz de dispositivo, y después de que el controlador llame a IWDFDevice2::CreateRemoteInterface para crear un objeto de interfaz remota, el controlador puede llamar a OpenRemoteInterface para que pueda enviar solicitudes de E/S a la interfaz del dispositivo.
La interfaz del dispositivo debe ser accesible por la cuenta que cargó el controlador basado en UMDF, que normalmente es la cuenta de servicio local. Sin embargo, si el controlador usa de suplantación cuando llama a OpenRemoteInterface, la interfaz del dispositivo debe ser accesible por la cuenta suplantada.
Para obtener más información sobre openRemoteInterface y cómo usar interfaces de dispositivo en controladores basados en UMDF, consulte Using Device Interfaces in UMDF-based Drivers.
Ejemplos
En el ejemplo de código siguiente se muestra cómo una IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival función de devolución de llamada puede crear una interfaz remota y objetos de destino remotos para una interfaz de dispositivo y, a continuación, abrir la interfaz para las operaciones de E/S.
void
STDMETHODCALLTYPE
CMyDevice::OnRemoteInterfaceArrival(
__in IWDFRemoteInterfaceInitialize * FxRemoteInterfaceInit
)
...
HRESULT hr;
CComPtr<IWDFRemoteInterface> fxRemoteInterface;
CComPtr<IWDFRemoteTarget> m_FxTarget;
hr = m_FxDevice->CreateRemoteInterface(FxRemoteInterfaceInit,
NULL,
&fxRemoteInterface);
if (FAILED(hr)) goto Error;
hr = FxDevice->CreateRemoteTarget(unknown,
fxRemoteInterface,
&m_FxTarget);
if (FAILED(hr)) goto Error;
hr = m_FxTarget->OpenRemoteInterface(fxRemoteInterface,
NULL,
GENERIC_READ | GENERIC_WRITE,
NULL);
...
Error:
...
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 |