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

Метод 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. При успешном возврате *Интерфейс содержит запрошенный указатель интерфейса на объект. Если объект не поддерживает интерфейс, указанный в InterfaceId, параметр *Interface имеет значение NULL.

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

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

Требования

См. также

ACCESS_MASK

IKsTopology

ZwCreateFile