функция обратного вызова EVT_ACX_VOLUME_RETRIEVE_LEVEL (acxelements.h)

Функция обратного вызова EVT_ACX_VOLUME_RETRIEVE_LEVEL реализуется драйвером и вызывается при запросе уровня тома указанного канала на узле тома.

Синтаксис

EVT_ACX_VOLUME_RETRIEVE_LEVEL EvtAcxVolumeRetrieveLevel;

NTSTATUS EvtAcxVolumeRetrieveLevel(
  ACXVOLUME Volume,
  ULONG Channel,
  LONG *VolumeLevel
)
{...}

Параметры

Volume

Существующий, инициализированный объект ACXVOLUME. Дополнительные сведения о объектах ACX см. в сводке по объектам ACX.

Channel

ULONG, ссылающийся на канал на указанном узле тома. Если это значение равно -1, он ссылается на главный канал, который задает уровень для всех каналов на узле тома.

VolumeLevel

Значение LONG, указывающее уровень тома канала в заданном потоке. Значения volumelevel используют следующий масштаб:

-2147483648 -infinity децибел (attenuation),

-2147483647 равно -32767.99998474 децибели (аттенуация) и

+2147483647 имеет значение +32767.99998474 децибели (прирост).

Возвращаемое значение

Возвращает 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_VOLUME_RETRIEVE_LEVEL       CodecR_EvtVolumeRetrieveLevel;

NTSTATUS
NTAPI
CodecR_EvtVolumeRetrieveLevel(
    _In_  ACXVOLUME Volume,
    _In_  ULONG     Channel,
    _Out_ LONG *    VolumeLevel
)
{
    PCODEC_VOLUME_ELEMENT_CONTEXT   volumeCtx;

    PAGED_CODE();

    volumeCtx = GetCodecVolumeElementContext(Volume);
    ASSERT(volumeCtx);

    if (Channel != ALL_CHANNELS_ID)
    {
        *VolumeLevel = volumeCtx->VolumeLevel[Channel];
    }
    else
    {
        *VolumeLevel = volumeCtx->VolumeLevel[0];
    }

    return STATUS_SUCCESS;
}

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

См. также

• acxelements.h заголовок