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 中请求的接口指针的变量 的指针的指针。 成功返回后,*Interface 包含指向 对象的请求接口指针。 如果对象不支持 InterfaceId 中指定的接口,则 *Interface 设置为 NULL

返回值

如果成功,则返回 NOERROR;否则,将返回错误代码。

要求

要求
目标平台 DesktopMobile
标头 ksproxy.h (包括 Ksproxy.h)

另请参阅

ACCESS_MASK

IKsTopology

ZwCreateFile