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
Header	ksproxy.h (Ksproxy.h を含む)

こちらもご覧ください

ACCESS_MASK

IKsTopology

ZwCreateFile