IKsTopologyInfo

IKsTopologyInfo インターフェースは、ストリームクラスドライバー内のノードを列挙します。KsProxy フィルターがこのインターフェースを公開します。アプリケーションはこのインターフェースを使用して、カーネルモードフィルターの内部トポロジを調べることができます。

Windows Driver Model において、カーネルストリーミング (KS) フィルターは 1 つ以上のノードを含みます。各ノードは、ストリームに適用される処理タスクをカプセル化します。ノードには入力と出力があり、フィルター内の他のノード、またはフィルターのピンに接続されます。このようにして、ノードはフィルター内部の小さな「フィルターグラフ」のようになり、複数の可能なデータパスを含む場合があります。アプリケーションは IKsTopologyInfo インターフェースを使用して、ノードおよびノード接続に関する情報を取得できます。

一部のデバイスは、入力ノードを選択するための ISelector インターフェースもサポートしています。たとえば、ビデオキャプチャデバイスにカメラとテープ搬送機構がある場合、これらは 2 つのノードとして表現できます(前の図を参照)。

Windows SDK、または DirectX 9.0 SDK Update (Summer 2004) 以降から Vidcap.h をインクルードしてください。

get_NumCategories メソッドは、このフィルターのカテゴリ数を返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

get_Category メソッドは、このストリームクラスドライバーのフィルターカテゴリの 1 つを返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

get_NumConnections メソッドは、フィルター内のノード接続数を返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

接続に関する情報を取得するには、IKsTopologyInfo::get_ConnectionInfo メソッドを呼び出します。

get_ConnectionInfo メソッドは、フィルター内の 1 つのノード接続に関する情報を返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

get_NodeName メソッドは、ノードの名前を返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

名前のバッファサイズを調べるには、pwchNodeName パラメーターに NULL、dwBufSize パラメーターに 0 を指定して、このメソッドを一度呼び出します。メソッドは pdwNameLen にバッファサイズを返します。この場合のメソッドの戻り値は HRESULT_FROM_WIN32(ERROR_MORE_DATA) です。その後、配列を割り当てて、メソッドを再度呼び出します。

例

// pKsTopo は IKsTopologyInfo ポインターです。
// iNode はノードのインデックスです。
DWORD cbName = 0;
hr = pKsTopo->get_NodeName(iNode, NULL, 0, &cbName);
if (hr == HRESULT_FROM_WIN32(ERROR_MORE_DATA))
{
    if (cbName > sizeof(WCHAR))
    {
        WCHAR *nodeName = new WCHAR[cbName / sizeof(WCHAR)];
        if (nodeName == NULL)
        {
            hr = E_OUTOFMEMORY;
        }
        else
        {
            hr = pKsTopo->get_NodeName(iNode, nodeName, cbName, &cbName);
            /* ... */
            delete [] nodeName;
        }
    }
}

get_NumNodes メソッドは、フィルター内のノード数を返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

get_NodeType メソッドは、指定されたノードのノードタイプを返します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

CreateNodeInstance メソッドは、フィルター内のノードを表す COM オブジェクトを作成します。

このメソッドは HRESULT を返します。取り得る値には次の表に示すものが含まれますが、これらに限定されません。

ノードオブジェクトは IKsControl インターフェースを公開します。このインターフェースを使用して、ノードのプロパティセットを列挙し、アクセスできます。