ピン カテゴリのプロパティ
USBオーディオデバイス、IEEE 1394オーディオデバイス、内部バス上のオーディオデバイス用のMicrosoft Windows Driver Model（WDM）オーディオドライバはすべて、デバイスをピンを持つKSフィルタとして表現します。 WDM オーディオ ドライバーメインサポートするピンの種類ごとに 1 つの KSPIN_DESCRIPTOR 構造が含まれています。 この構造体の中に、ドライバはピンタイプの KSPROPSETID_Pin プロパティを格納する。 これらのプロパティの中には、 KSPROPERTY_PIN_CATEGORY プロパティがあります。 このプロパティへの要求は、 KSPIN_DESCRIPTOR 構造体の Category メンバからKSピンカテゴリGUIDを取得します。 この GUID は、ピンが提供する機能の一般的なカテゴリを示します。 たとえば、特定のピン カテゴリ GUID (KSNODETYPE_HEADPHONES) は、ヘッドフォンの出力ジャックとしてピンを識別します。
内部バス (PCI など) 上のウェーブ オーディオ デバイスの場合、PortCls ミニポート ドライバーには、デバイスを表すフィルター内のピンの種類を記述するピン記述子の配列が含まれています。 各ピンディスクリプタは、 PCPIN_DESCRIPTOR 構造体で、ピンカテゴリGUIDを持つ KSPIN_DESCRIPTOR 構造体が組み込まれています。 クライアントから KSPROPERTY_PIN_CATEGORY プロパティ要求を受信すると、ポート ドライバーは、指定したピンの種類のミニポート ドライバーのピン記述子からピン カテゴリ GUID を取得します。 ピン記述子の詳細については、「 ピン ファクトリ」を参照してください。
USBオーディオデバイスには、デジタルストリームとアナログ信号がデバイスを出入りできるいくつかの端子があります。 USB オーディオ デバイスを表す KS フィルターを構築する場合、 USBAudio クラス システム ドライバー は、デバイス上のターミナルをフィルターのピンに変換します。 ヘッダー ファイル Ksmedia.h は、各 USB ターミナルの種類識別子のマッピングを KS ピン カテゴリ GUID に定義します。 次の 6 つの表は、ターミナルの種類の識別子とそれに対応するピン カテゴリ GUID を示しています。
入力ターミナルの種類
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0201 |
KSNODETYPE_MICROPHONE |
0x0202 |
KSNODETYPE_DESKTOP_MICROPHONE |
0x0203 |
KSNODETYPE_PERSONAL_MICROPHONE |
0x0204 |
KSNODETYPE_OMNI_DIRECTIONAL_MICROPHONE |
0x0205 |
KSNODETYPE_MICROPHONE_ARRAY |
0x0206 |
KSNODETYPE_PROCESSING_MICROPHONE_ARRAY |
出力ターミナルの種類
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0301 |
KSNODETYPE_SPEAKER |
0x0302 |
KSNODETYPE_HEADPHONES |
0x0303 |
KSNODETYPE_HEAD_MOUNTED_DISPLAY_AUDIO |
0x0304 |
KSNODETYPE_DESKTOP_SPEAKER |
0x0305 |
KSNODETYPE_ROOM_SPEAKER |
0x0306 |
KSNODETYPE_COMMUNICATION_SPEAKER |
0x0307 |
KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER |
双方向ターミナルの種類
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0401 |
KSNODETYPE_HANDSET |
0x0402 |
KSNODETYPE_HEADSET |
0x0403 |
KSNODETYPE_SPEAKERPHONE_NO_ECHO_REDUCTION |
0x0404 |
KSNODETYPE_ECHO_SUPPRESSING_SPEAKERPHONE |
0x0405 |
KSNODETYPE_ECHO_CANCELING_SPEAKERPHONE |
テレフォニー ターミナルの種類
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0501 |
KSNODETYPE_PHONE_LINE |
0x0502 |
KSNODETYPE_TELEPHONE |
0x0503 |
KSNODETYPE_DOWN_LINE_PHONE |
外部ターミナルの種類
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0601 |
KSNODETYPE_ANALOG_CONNECTOR |
0x0602 |
KSNODETYPE_DIGITAL_AUDIO_INTERFACE |
0x0603 |
KSNODETYPE_LINE_CONNECTOR |
0x0604 |
KSNODETYPE_LEGACY_AUDIO_CONNECTOR |
0x0605 |
KSNODETYPE_SPDIF_INTERFACE |
0x0606 |
KSNODETYPE_1394_DA_STREAM |
0x0607 |
KSNODETYPE_1394_DV_STREAM_SOUNDTRACK |
埋め込み関数のターミナル型
| USBターミナルID | KS ピン カテゴリ GUID |
|---|---|
0x0701 |
KSNODETYPE_LEVEL_CALIBRATION_NOISE_SOURCE |
0x0702 |
KSNODETYPE_EQUALIZATION_NOISE |
0x0703 |
KSNODETYPE_CD_PLAYER |
0x0704 |
KSNODETYPE_DAT_IO_DIGITAL_AUDIO_TAPE |
0x0705 |
KSNODETYPE_DCC_IO_DIGITAL_COMPACT_CASSETTE |
0x0706 |
KSNODETYPE_MINIDISK |
0x0707 |
KSNODETYPE_ANALOG_TAPE |
0x0708 |
KSNODETYPE_PHONOGRAPH |
0x0709 |
KSNODETYPE_VCR_AUDIO |
0x070A |
KSNODETYPE_VIDEO_DISC_AUDIO |
0x070B |
KSNODETYPE_DVD_AUDIO |
0x070C |
KSNODETYPE_TV_TUNER_AUDIO |
0x070D |
KSNODETYPE_SATELLITE_RECEIVER_AUDIO |
0x070E |
KSNODETYPE_CABLE_TUNER_AUDIO |
0x070F |
KSNODETYPE_DSS_AUDIO |
0x0710 |
KSNODETYPE_RADIO_RECEIVER |
0x0711 |
KSNODETYPE_RADIO_TRANSMITTER |
0x0712 |
KSNODETYPE_MULTITRACK_RECORDER |
0x0713 |
KSNODETYPE_SYNTHESIZER |
USBターミナルタイプ識別子の詳細については、 USBインプリメンターズフォーラム のウェブサイトで入手可能な 端末タイプのユニバーサルシリアルバスデバイスクラス定義 (リリース1.0)を参照してください。
上記の表のすべてのピン カテゴリ GUID には、フォーム KSNODETYPE_XXX のパラメーター名があります。 KS ノード・タイプ GUID にも、KSNODETYPE_XXX パラメーター名があることに注意してください。 この名前付け規則により、ピン カテゴリ GUID とノード タイプ GUID の間で混乱が生じる可能性があります。 幸いにも、ほぼすべてのKSNODETYPE_XXX パラメーターは、ピン カテゴリまたはノードの種類を識別しますが、両方を識別するわけではありません。 ルールの 1 つの例外は KSNODETYPE_SYNTHESIZERであり、コンテキストに応じてピン カテゴリまたはノード タイプを識別できます。 ノード タイプ GUID の一覧については、「 オーディオ トポロジ ノード」を参照してください。
USB オーディオ デバイスをインスタンス化する場合、USBAudio クラス システム ドライバーは、デバイスの内部トポロジ (ターミナルを含む) を照会します。 USBAudio ドライバーは、この情報を使用して、デバイスを表すフィルターを構築し、各ターミナルをフィルターの対応するピンに変換します。 このプロセス中、ドライバーは、各 USB ターミナルの種類の識別子を対応する KS ピン カテゴリ GUID に変換します。これは、上記の表の GUID のいずれかです。 ドライバーは、ピンを 記述する KSPIN_DESCRIPTOR 構造体を構築し、ピン カテゴリ GUID を構造体に書き込みます。
PortCls ミニポート ドライバーは、前の 6 つのテーブルに表示されるカテゴリ GUID のみを必ずしも使用しません。 たとえば、ドライバーは、カスタムピン カテゴリ GUID を定義して使用して、機能カテゴリがテーブル内のカテゴリの外にあるピンの種類を記述する場合があります。 当然ながら、カスタム ピン カテゴリ GUID は、GUID を認識するクライアントにのみ役立ちます。
オーディオ サブシステムメイン、ピン カテゴリ GUID とそれに関連付けられているフレンドリ名の一覧がシステム レジストリに含まれています。 メディア クラス インストーラーは、メイン Windows フォルダーの Inf サブフォルダー (C:\Windows\Inf\Ks.inf など) にある Ks.inf ファイルから GUID 名のペアをレジストリにコピーします。
オペレーティング システムでは、ピン カテゴリを使用してフレンドリ名をオーディオ エンドポイント デバイスに関連付けます。 フレンドリ名をオーディオ エンドポイント デバイスに関連付ける方法の詳細については、「 オーディオ エンドポイント デバイスのフレンドリ名」を参照してください。