ホーム › Media.KernelStreaming › IKsJackDescription2
IKsJackDescription2
COM公式ドキュメント
IKsJackDescription2 インターフェースは、オーディオアダプター上のデバイスと、外部または内部のエンドポイントデバイス(たとえばマイクや CD プレーヤー)との間の物理的な接続を提供するジャックまたは内部コネクターに関する情報を提供します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
GetJackCount メソッドは、エンドポイントデバイスへの接続に必要な、コネクター上のジャックの数を取得します。
| pcJacks | DWORD* | out | コネクターに関連付けられているオーディオジャックの数を受け取ります。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合、返される可能性のあるコードには、次の表に示す値が含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| ポインター pcJacks が NULL です。 |
vtbl 4 HRESULT GetJackDescription2(DWORD nJack, KSJACK_DESCRIPTION2* pDescription2)
GetJackDescription2 メソッドは、指定されたオーディオジャックの記述を取得します。
| nJack | DWORD | in | 記述を取得するジャックのインデックス。接続が n 個のジャックで構成される場合、ジャックには 0 から n– 1 までの番号が付けられます。ジャックの数を取得するには、IKsJackDescription::GetJackCount メソッドを呼び出します。 |
| pDescription2 | KSJACK_DESCRIPTION2* | out | ジャックに関する情報を格納する KSJACK_DESCRIPTION2 型の構造体を、メソッドが書き込む、呼び出し側が割り当てたバッファーへのポインター。バッファーのサイズは少なくとも sizeof(KSJACK_DESCRIPTION2) でなければなりません。 |
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合、返される可能性のあるコードには、次の表に示す値が含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| パラメーター nJack が有効なジャックインデックスではありません。 | |
| ポインター pDescription が NULL です。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IKsJackDescription2 "{478F3A9B-E0C9-4827-9228-6F5505FFE76A}" #usecom global IKsJackDescription2 IID_IKsJackDescription2 "{}" #comfunc global IKsJackDescription2_GetJackCount 3 var #comfunc global IKsJackDescription2_GetJackDescription2 4 int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IKsJackDescription2 "{478F3A9B-E0C9-4827-9228-6F5505FFE76A}" #usecom global IKsJackDescription2 IID_IKsJackDescription2 "{}" #comfunc global IKsJackDescription2_GetJackCount 3 sptr #comfunc global IKsJackDescription2_GetJackDescription2 4 int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。