KSEVENT_PINCAPS_FORMATCHANGE
KSEVENT_PINCAPS_FORMATCHANGE イベントは、オーディオ デバイスのオーディオ データ形式が変更されたことをオーディオ スタックに示します。
用法の要点テーブル
| 移行先 | イベント記述子の型 | イベント値の型 |
|---|---|---|
ピン留めする |
イベント値の型 (操作データ) は、このイベントに使用する通知方法を指定する KSEVENTDATA 構造体です。
解説
オーディオ ポート ドライバーは、ミニポート ドライバーの EventHandler ルーチンを呼び出すと、PCEVENT_REQUEST 構造体を渡します。 この構造体には、フィルター、ピン、またはノードでサポートされるイベントを記述するために使用されるPCEVENT_ITEM 構造体へのポインターが含まれています。
そのため、たとえば、KSEVENT_PINCAPS_FORMATCHANGE イベントをサポートするドライバーは、次のように PCEVENT_ITEM 構造体を設定する必要があります。
static PCEVENT_ITEM FormatChangePinEvent[] = {
{
&KSEVENTSETID_PinCapsChange,
KSEVENT_PINCAPS_FORMATCHANGE,
KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
MyEventHandler
}
};
前のコード例では、MyEventHandler カスタム イベント ハンドラーは、KSEVENT_PINCAPS_FORMATCHANGE がトリガーされたときに KSEVENT_PINCAPS_FORMATCHANGE イベントを監視し、Portcls に登録する必要があります。 ミニポート ドライバーは、イベントを登録する IPortEvents::AddEventToEventList メソッドを呼び出す必要があります。
ミニポート ドライバーでサポートされているピン、ノード、接続、プロパティの説明を取得するには、ポート ドライバーは IMiniport::GetDescription メソッドを呼び出します。 このメソッド呼び出しは、オートメーション テーブル (PCAUTOMATION_TABLE) を指す PCFILTER_DESCRIPTOR 構造体を返します。 PCAUTOMATION_TABLE 構造体には Events メンバーがあります。 このメンバーは、ミニポート ドライバーがサポートするフィルターに関連付けられているイベントの配列を指します。 そのため、KSEVENT_PINCAPS_FORMATCHANGE イベントの PCEVENT_ITEM 構造体を含むイベント配列を指す Events メンバーを設定する必要があります。
ミニポート ドライバーは、動的な形式の変更を検出すると、KSEVENT_PINCAPS_FORMATCHANGE イベントを通知する IPortEvents::GenerateEventList を呼び出す必要があります。
要件
バージョン |
Windows 7 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー |
Ks.h (Ks.h を含む) |
関連項目
IPortEvents::AddEventToEventList