Метод IWDFDevice2::CreateRemoteInterface (wudfddi.h)

Статья
02/07/2025

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод createRemoteInterface создает объект удаленного интерфейса, представляющий интерфейс устройства.

Синтаксис

HRESULT CreateRemoteInterface(
  [in]           IWDFRemoteInterfaceInitialize *pRemoteInterfaceInit,
  [in, optional] IUnknown                      *pCallbackInterface,
  [out]          IWDFRemoteInterface           **ppRemoteInterface
);

Параметры

[in] pRemoteInterfaceInit

Указатель на интерфейс IWDFRemoteInterfaceInitialize, полученный функции обратного вызова драйвера IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival.

[in, optional] pCallbackInterface

Указатель на дополнительный интерфейс обратного вызова, предоставленный драйвером. Метод IUnknown::QueryInterface этого интерфейса должен вернуть указатель на драйвера IRemoteInterfaceCallbackEvent и интерфейсы IRemoteInterfaceCallbackRemoval, если драйвер поддерживает эти интерфейсы. Этот параметр является необязательным и может быть null.

[out] ppRemoteInterface

Указатель на указанное драйвером расположение, которое получает указатель на интерфейс IWDFRemoteInterface нового объекта удаленного интерфейса.

Возвращаемое значение

CreateRemoteInterface возвращает S_OK, если операция выполнена успешно. В противном случае метод может вернуть следующее значение:

Возвращаемый код	Описание
E_OUTOFMEMORY	Попытка платформы выделить память завершилась ошибкой.

Этот метод может возвращать одно из других значений, содержащихся в Winerror.h.

Замечания

Если драйвер вызывает CreateRemoteInterface, это необходимо сделать из функции обратного вызова IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival.

Дополнительные сведения о CreateRemoteInterface и использовании интерфейсов устройств см. в использовании интерфейсов устройств в драйверах на основе UMDF

Примеры

В следующем примере кода показана функция обратного вызова IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival, которая создает объект удаленного интерфейса, создает удаленный целевой объект и открывает удаленный целевой объект для операций ввода-вывода.

void 
STDMETHODCALLTYPE
CMyDevice::OnRemoteInterfaceArrival(
    __in IWDFRemoteInterfaceInitialize * FxRemoteInterfaceInit
    )
{
    HRESULT hr = S_OK;

    //
    // Create a new remote interface object and provide a callback 
    // object to handle remote interface events.
    //
    CComPtr<IWDFRemoteInterface> fxRemoteInterface;
    hr = m_FxDevice->CreateRemoteInterface(FxRemoteInterfaceInit, 
                                           MyRemoteInterfaceIUnknown, 
                                           &fxRemoteInterface);
    if (FAILED(hr)) goto Error;
    //
    // Create a new remote target object and provide a callback 
    // object to handle remote target events.
    //
    CComPtr<IWDFRemoteTarget> fxTarget;
    hr = m_FxDevice->CreateRemoteTarget(MyRemoteTargetIUnknown,
                                        fxRemoteInterface,
                                        &fxTarget);
    if (FAILED(hr)) goto Error;

    //
    // Open the remote interface with read/write access.
    //
    hr = FxTarget->OpenRemoteInterface(fxRemoteInterface, 
                                       NULL,
                                       GENERIC_READ | GENERIC_WRITE,
                                       NULL);
    if (FAILED(hr)) goto Error;
...
}

Требования

Требование	Ценность
завершение поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа	Настольный
минимальная версия UMDF	1.9
заголовка	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

См. также

IWDFDevice2

IWDFDevice2::CreateRemoteTarget

IWDFRemoteTarget::OpenRemoteInterface

Поделиться через