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;否则，将返回错误代码。

要求

另请参阅

ACCESS_MASK

IKsTopology

ZwCreateFile