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 標頭