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

Статья
02/07/2025

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

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

Синтаксис

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

Параметры

[in, optional] pCallbackInterface

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

[in, optional] pParentObject

Указатель на объект платформы. Если драйвер предоставляет этот необязательный указатель, указанный объект становится родительским элементом нового удаленного целевого объекта. Если этот параметр NULL, объект устройства, предоставляющий интерфейс IWDFDevice2, становится родительским. Платформа удаляет удаленный целевой объект при удалении родительского объекта.

[out] ppRemoteTarget

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

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

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

Возвращаемый код	Описание
E_OUTOFMEMORY	Попытка платформы выделить память завершилась ошибкой.
HRESULT_FROM_WIN32 (ERROR_INVALID_PARAMETER)	Параметр pParentObject не указал объект устройства, предоставляющий интерфейс IWDFDevice2 или объект, цепочка родителей которого приводит к этому объекту.

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

Замечания

После вызова драйвера CreateRemoteTargetдрайвер может открыть удаленный целевой объект, вызвав IWDFRemoteTarget::OpenRemoteInterface (чтобы открыть интерфейс устройства) или IWDFRemoteTarget::OpenFileByName (чтобы открыть файл).

Если драйвер использует параметр pParentObject для указания родительского объекта, родительский объект может быть объектом устройства, предоставляющим интерфейс IWDFDevice2, или любой объект, цепочка родителей которого приводит к этому объекту устройства. Платформа удаляет удаленный целевой объект, когда он (или драйвер) удаляет объект устройства.

Дополнительные сведения о удаленных целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода вUMDF.

Примеры

Примеры кода, использующие CreateRemoteTarget, см. в примерах кода IWDFDevice2::CreateRemoteInterface и IWDFRemoteTarget::OpenFileByName.

Требования

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

См. также

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface

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