EVT_ACX_PEAKMETER_RETRIEVE_LEVEL fonction de rappel (acxelements.h)
La fonction de rappel EVT_ACX_PEAKMETER_RETRIEVE_LEVEL est implémentée par le pilote et est appelée lorsque le niveau d’un canal spécifié sur un nœud peakmeter est demandé.
Syntaxe
EVT_ACX_PEAKMETER_RETRIEVE_LEVEL EvtAcxPeakmeterRetrieveLevel;
NTSTATUS EvtAcxPeakmeterRetrieveLevel(
ACXPEAKMETER PeakMeter,
ULONG Channel,
LONG *Level
)
{...}
Paramètres
PeakMeter
Objet ACXPEAKMETER existant, initialisé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
Channel
ULONG faisant référence à un canal sur le nœud peakmeter spécifié. Si cette valeur est -1, elle fait référence au canal maître qui définit le niveau de tous les canaux sur le nœud peakmeter.
Level
Valeur LONG qui indique le niveau maximal de signal audio qui s’est produit pour le canal spécifié sur le nœud peakmeter depuis la dernière réinitialisation du nœud peakmeter.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Exemple
L’exemple d’utilisation est illustré ci-dessous.
typedef struct _CODEC_PEAKMETER_ELEMENT_CONTEXT {
LONG PeakMeterLevel[MAX_CHANNELS];
} CODEC_PEAKMETER_ELEMENT_CONTEXT, *PCODEC_PEAKMETER_ELEMENT_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_PEAKMETER_ELEMENT_CONTEXT, GetCodecPeakMeterElementContext)
EVT_ACX_PEAKMETER_RETRIEVE_LEVEL CodecR_EvtPeakMeterRetrieveLevelCallback;
NTSTATUS
NTAPI
CodecR_EvtPeakMeterRetrieveLevelCallback(
_In_ ACXPEAKMETER PeakMeter,
_In_ ULONG Channel,
_Out_ LONG * PeakMeterLevel
)
{
PAGED_CODE();
ASSERT(PeakMeter);
PCODEC_PEAKMETER_ELEMENT_CONTEXT peakmeterCtx = GetCodecPeakMeterElementContext(PeakMeter);
ASSERT(peakmeterCtx);
if (Channel == ALL_CHANNELS_ID)
{
Channel = 0;
}
*PeakMeterLevel = peakmeterCtx->PeakMeterLevel[Channel];
return STATUS_SUCCESS;
}
Configuration requise pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxelements.h |
| IRQL | PASSIVE_LEVEL |