IKsTopology::CreateNodeInstance メソッド (ksproxy.h)

[アーティクル]
02/26/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 に設定されます。