次の方法で共有


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 で指定されたインターフェイスサポートしていない場合は、*インターフェイス が NULL 設定されます。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラー コードを返します。

必要条件

要件 価値
ターゲット プラットフォーム DesktopMobile
ヘッダー ksproxy.h (Ksproxy.h を含む)

関連項目

ACCESS_MASK

IKsTopology

ZwCreateFile