Метод IKsTopology::CreateNodeInstance (ksproxy.h)

Статья
02/29/2024

Метод CreateNodeInstance запрашивает объект фильтра KS, чтобы открыть объект узла топологии.

Синтаксис

HRESULT CreateNodeInstance(
  [in]           ULONG       NodeId,
  [in]           ULONG       Flags,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] IUnknown    *UnkOuter,
  [in]           REFGUID     InterfaceId,
  [out]          LPVOID      *Interface
);

Параметры

[in] NodeId

Идентификатор открываемого объекта узла топологии.

[in] Flags

Битовая маска, перечисляющая тип объекта узла топологии. В настоящее время флаги не определены.

[in] DesiredAccess

Битовая маска ACCESS_MASK, указывающая тип доступа, который требуется вызывающей объекту узла топологии. Описание каждого значения прав доступа см. в разделе ZwCreateFile .

[in, optional] UnkOuter

Указатель на интерфейс IUnknown , поддерживающий интерфейс узла топологии.

[in] InterfaceId

Идентификатор запрашиваемого интерфейса узла топологии.

[out] Interface

Указатель на переменную, которая получает указатель интерфейса, запрошенный в InterfaceId. После успешного возврата *Interface содержит запрошенный указатель интерфейса на объект . Если объект не поддерживает интерфейс, указанный в InterfaceId, *Interface имеет значение NULL.

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

Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.

Требования

Требование	Значение
Целевая платформа	DesktopMobile
Верхняя часть	ksproxy.h (включая Ksproxy.h)

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

ACCESS_MASK

IKsTopology

ZwCreateFile

Share via