EVT_ACX_VOLUME_ASSIGN_LEVEL回呼函式 (acxelements.h)
EVT_ACX_VOLUME_ASSIGN_LEVEL回呼函式是由驅動程序實作,而且會在為磁碟區節點設定通道的磁碟區層級時呼叫。
語法
EVT_ACX_VOLUME_ASSIGN_LEVEL EvtAcxVolumeAssignLevel;
NTSTATUS EvtAcxVolumeAssignLevel(
ACXVOLUME Volume,
ULONG Channel,
LONG VolumeLevel
)
{...}
參數
Volume
現有、初始化的 ACXVOLUME 物件。 如需 ACX 對象的詳細資訊,請參閱 ACX 物件的摘要。
Channel
ULONG,參考指定磁碟區節點上的通道。 如果此值為 -1,則它會參考主要通道,代表磁碟區節點上所有通道的磁碟區層級。
VolumeLevel
LONG 值,指定磁碟區節點中信道的磁碟區層級。 如果通道值為 -1 (參考主要通道) ,則此磁碟區節點上的所有通道都會設定為此磁碟區層級。 磁碟區層級值會使用下列小數字數:
-2147483648 為 -infinity decibels (衰減) ,
-2147483647 為 -32767.99998474 decibels (衰減) 和
+2147483647 為 +32767.99998474 decibels () 。
傳回值
如果呼叫成功,則傳 STATUS_SUCCESS
回 。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱 使用NTSTATUS值。
備註
範例
範例使用方式如下所示。
typedef struct _VOLUME_ELEMENT_CONTEXT {
LONG VolumeLevel[MAX_CHANNELS];
} VOLUME_ELEMENT_CONTEXT, *PVOLUME_ELEMENT_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(VOLUME_ELEMENT_CONTEXT, GetVolumeElementContext)
EVT_ACX_VOLUME_ASSIGN_LEVEL CodecC_EvtVolumeAssignLevelCallback;
NTSTATUS
CodecC_EvtVolumeAssignLevelCallback(
_In_ ACXVOLUME Volume,
_In_ ULONG Channel,
_In_ LONG VolumeLevel
)
{
PAGED_CODE();
ASSERT(Volume);
PVOLUME_ELEMENT_CONTEXT volumeCtx = GetVolumeElementContext(Volume);
ASSERT(volumeCtx);
if (Channel != ALL_CHANNELS_ID)
{
volumeCtx->VolumeLevel[Channel] = VolumeLevel;
}
else
{
for (ULONG i = 0; i < MAX_CHANNELS; ++i)
{
volumeCtx->VolumeLevel[i] = VolumeLevel;
}
}
return STATUS_SUCCESS;
}
ACX 需求
最小 ACX 版本: 1.0
如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀。
規格需求
需求 | 值 |
---|---|
標頭 | acxelements.h |
IRQL | PASSIVE_LEVEL |