KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED は、Windows 8.1 で設定されている KSPROPSETID_Audio プロパティに追加された新しい KS プロパティです。

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED プロパティ要求は、エンド ユーザーの音量レベルの制限設定を基になるドライバーに渡します。 このプロパティのスコープは、ピンごと (またはエンド ユーザーの観点から、オーディオ エンドポイントごと) です。

用法の要点テーブル

プロパティ値は BOOL 型であり、エンドユーザーが、最大音量が特定の制限を超えることを許可しているかどうかを示します。 値 TRUE は、エンド ユーザーが、音量レベルがポストされた制限を超えるのを許可していることを示し、FALSE はその逆を示します。 子アカウントの場合、値は常に FALSE になります。

ドライバーはこのプロパティの値を内部変数に格納し、起動時に値を TRUE に初期化します。 このプロパティが TRUE の場合、ドライバーは最大音量レベルを制限します。 プロパティが FALSE に設定されている場合、ドライバーはこれらの制限を削除できます。

ドライバーは、このプロパティの値を自動的に変更することもできます。 たとえば、ドライバーはプロパティ値を TRUE から FAL に自動的に切り替えてから、特定のサウンド レベルを超える時間が経過した後、音量レベルの制限を開始できます。

プロパティの値が変更されるたびに (変更が自動的なものか、プロパティ値を設定する呼び出し元によるものかは不問)、ドライバーは KSEVENT_PINCAPS_VOLUMELIMITCHANGE イベントを生成する必要があります。

戻り値

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED プロパティ要求は、要求が成功すると STATUS_SUCCESS を返します。

要件