KsStudio ユーティリティ - フィルターとフィルター ファクトリ
このトピックでは、KSStudioユーティリティを使用してフィルタおよびフィルタファクトリを表示する方法について説明します。
Microsoft Windows Driver Model (WDM) オーディオ ドライバーは、オーディオ デバイスを KS フィルターとして表し、デバイス上のハードウェア バッファーをフィルターのピンとして表します。 詳しくは、「フィルター、ピン、およびノード プロパティ」を参照してください。
KS フィルター ファクトリ列挙オプション
KSStudio のセッションは、通常、システムにインストールされている KS フィルター ファクトリを列挙することから始まります。 既定では、起動時にユーザーに列挙オプション ダイアログが表示されます。 このダイアログは、起動後にメニュー バー (View.Options...) を使用していつでも呼び出すことができます。
KSStudio でフィルターを列挙するには、次の 2 つの方法があります。
API のセットアップ。 これは、フィルター ファクトリ列挙の最も一般的で便利な手段です。 フィルター ファクトリがシステムに正しくインストールされている場合は、1 つ以上のフィルター カテゴリ (KSCATEGORY_AUDIO、KSCATEGORY_RENDER など) を介して列挙可能になります。 「クラス...」ボタンをクリックすると、列挙するカテゴリを選択できます。 これにより、KSMedia.h で現在宣言されているすべてのカテゴリを表示するダイアログが呼び出されます。
デバイス名で明示的に指定します。 セットアップ API がフィルター ファクトリを列挙しないが、ドライバーがインストールされている場合 (つまり、デバイス マネージャーでエラーなしで表示される)、名前でデバイスを明示的にインスタンス化できる可能性があります。 これを行うには、[追加フィルター] 編集コントロールにデバイス名を入力します。 これは、列挙の問題 (INF エラーなど) のトラブルシューティングに役立つ場合があります。
KSStudio には、KSStudio プログラムにのみ存在するいくつかの "テスト フィルター" も用意されています。 これらのテスト フィルターを使用すると、データを KS フィルターに直接ストリーミングできます。これは、トラブルシューティングの目的に役立つ場合があります。
KSStudio が列挙するインストール済みのフィルター ファクトリは、KSStudio ユーティリティで説明されているフィルター ファクトリ ビューに表示されます。
フィルター ファクトリ
列挙されたフィルター ファクトリは、フィルター ファクトリ ビューに表示されます。 フィルターファクトリはWDMドライバーのファセットであり、フィルター（これはカーネルオブジェクトである）をインスタンス化するためにCreateFileに渡すことができるデバイス名を公開する。 列挙されたフィルター ファクトリごとに、KSStudio によって、Windows セットアップ API を使用して取得された属性の一覧が、実際にフィルターをインスタンス化せずに表示されます。
デバイス名属性は、ユーザーがフィルターのインスタンス化をCreateFile選択したときに KSStudio によって渡される文字列です。
フィルターのインスタンス化
フィルタをインスタンス化するには、フィルタファクトリビューでフィルタファクトリをダブルクリックします（または、ファクトリを右クリックしてインスタンス化を選択します）。 インスタンス化が成功した場合、KSStudio はフィルターを (プロパティ呼び出しの集中処理を介して) 問い合させ、取得した値を使用してプロファイルを構築します。 このプロファイルは、オブジェクトトポロジービューではプロパティ値から推測されるフィルターインスタンスのグラフィカルな表現を、オブジェクトの詳細表示では実際に得られたプロパティ値を示すテキスト表現を生成するために使用されます。
フィルターを閉じるには、フィルターを右クリックし、ポップアップ メニューから [閉じる] を選択します。
フィルターをテストする
KSStudio にはいくつかの組み込みのテスト フィルターまたはデータ ポンプが付属しているため、KS フィルター グラフによって入力または使用されるデータ バッファーが送信されるため、名前が付けられています。
Wave ファイル ポンプ。 このフィルターは.wavファイルを読み取り、KSDATAFORMAT_TYPE_AUDIOデータを使用できるピンにデータを送信します。
MIDI ファイル ポンプ。 このフィルターは、.midまたは .rmi ファイルを読み取り、KSDATAFORMAT_TYPE_MUSICデータを使用できるピンにデータを送信します。
ウェーブキャプチャポンプ。 このフィルターは、KSDATAFORMAT_AUDIOデータを提供できるピンに空のバッファーを送信します。 データはVUメーターを使用して表示されます。
MIDI キャプチャ ポンプ。 このフィルターは、KSDATAFORMAT_AUDIOデータを提供できるピンに空のバッファーを送信します。 データは、未加工および翻訳された MIDI メッセージとしてログウィンドウに表示されます。
全二重の流れポンプ。 このフィルターは、空のバッファーをKSDATAFLOW_INピンに送信し、取得したデータをKSDATAFLOW_OUTピンに再送信します。 たとえば、このポンプを使用して、マイク ピンから PCM データをキャプチャし、レンダー ピンに再送信できます。