EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL回呼函式 (acxelements.h)
EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL回呼是由驅動程序實作，而且會在為磁碟區節點設定通道的磁碟區層級時呼叫。
語法
EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL EvtAcxRampedVolumeAssignLevel;
NTSTATUS EvtAcxRampedVolumeAssignLevel(
ACXVOLUME Volume,
ULONG Channel,
LONG VolumeLevel,
ACX_VOLUME_CURVE_TYPE CurveType,
ULONGLONG CurveDuration
)
{...}
參數
Volume
現有、初始化的 ACXVOLUME 物件。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
Channel
參考指定磁碟區節點上通道的ULONG。 如果此值為 -1，則它會參考主要通道，代表磁碟區節點上所有通道的磁碟區層級。
VolumeLevel
LONG 值，指定指定指定通道所需的最終磁碟區層級。 如果通道值為 -1 (參照主要通道) ，則此磁碟區節點上的所有通道都會設定為此磁碟區層級。 磁碟區層級值會使用下列小數字數：
-2147483648 為 -infinity decibels (衰減) ，
-2147483647 為 -32767.99998474 decibels (衰減) 和
+2147483647 為 +32767.99998474 decibels (取得) 。
CurveType
使用 AUDIO_CURVE_TYPE列舉 來指定要在指定期間內套用的曲線演算法，以達到所需的層級。 曲線會從目前的磁碟區層級開始，並結束於 Volume 參數中指定的目標磁碟區層級。
CurveDuration
指定數百個奈秒的持續時間，此持續時間必須生效。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
範例
範例使用方式如下所示。
typedef struct _CODEC_VOLUME_ELEMENT_CONTEXT {
LONG VolumeLevel[MAX_CHANNELS];
} CODEC_VOLUME_ELEMENT_CONTEXT, *PCODEC_VOLUME_ELEMENT_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_VOLUME_ELEMENT_CONTEXT, GetCodecVolumeElementContext)
EVT_ACX_RAMPED_VOLUME_ASSIGN_LEVEL CodecR_EvtRampedVolumeAssignLevel;
NTSTATUS
NTAPI
CodecR_EvtRampedVolumeAssignLevel(
_In_ ACXVOLUME Volume,
_In_ ULONG Channel,
_In_ LONG VolumeLevel,
_In_ ACX_VOLUME_CURVE_TYPE CurveType,
_In_ ULONGLONG CurveDuration
)
{
PCODEC_VOLUME_ELEMENT_CONTEXT volumeCtx;
ULONG i;
PAGED_CODE();
UNREFERENCED_PARAMETER(CurveType);
UNREFERENCED_PARAMETER(CurveDuration);
volumeCtx = GetCodecVolumeElementContext(Volume);
ASSERT(volumeCtx);
if (Channel != ALL_CHANNELS_ID)
{
volumeCtx->VolumeLevel[Channel] = VolumeLevel;
}
else
{
for (i = 0; i < MAX_CHANNELS; ++i)
{
volumeCtx->VolumeLevel[i] = VolumeLevel;
}
}
return STATUS_SUCCESS;
}
ACX 需求
最低 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxelements.h |
| IRQL | PASSIVE_LEVEL |