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

Статья
08/08/2023

[Предупреждение: 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 (включая Wudfddi.h)
DLL	WUDFx.dll

См. также раздел

IWDFDevice2

IWDFRemoteTarget::OpenFileByName

IWDFRemoteTarget::OpenRemoteInterface

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