KsCreateTopologyNode2 関数 (ks.h)

トポロジ ノード インスタンスへのハンドルを作成します。

Windows 8 以降でサポートされています。

構文

KSDDKAPI HRESULT KsCreateTopologyNode2(
  [in]  HANDLE         ParentHandle,
  [in]  PKSNODE_CREATE NodeCreate,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        NodeHandle
);

パラメーター

[in] ParentHandle

ノードが作成される親へのハンドルを指定します。

[in] NodeCreate

トポロジ ノード ハンドルの作成に使用される情報のセットを記述する KSNODE_CREATE 構造体。

[in] DesiredAccess

オブジェクトへの必要なアクセスを示す ACCESS_MASK を指定します。 これは通常、 GENERIC_READGENERIC_WRITEです。

[out] NodeHandle

トポロジ ノード ハンドルの場所。

戻り値

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

注釈

これは KsCreateTopologyNode 関数の新しいバージョンであり、デバイス ブローカーを使用してカーネル ストリーミング オブジェクトへのハンドルを作成します。 さらに、この関数を呼び出す前に、コンポーネント オブジェクト モデル (COM) CoInitialize 関数を呼び出す必要があります。

要件

要件
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

ACCESS_MASK

CoInitialize

KSNODE_CREATE

KsCreateTopologyNode