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