EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT fonction de rappel (acxelements.h)
Le rappel EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT est implémenté par le pilote et est appelé lorsque le format de mixage interne est demandé pour le moteur audio spécifié.
Syntaxe
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT EvtAcxAudioengineRetrieveEngineFormat;
NTSTATUS EvtAcxAudioengineRetrieveEngineFormat(
ACXAUDIOENGINE AudioEngine,
ACXDATAFORMAT *Format
)
{...}
Paramètres
AudioEngine
Objet ACXAUDIOENGINE pour lequel le format de mixage a été demandé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
Format
Objet ACXDATAFORMAT qui décrit le format de mixage du moteur audio.
Valeur retournée
Retourne STATUS_SUCCESS
si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Exemple
L’exemple d’utilisation est illustré ci-dessous.
typedef struct _CODEC_ENGINE_CONTEXT {
ACXDATAFORMAT MixFormat;
BOOLEAN GFxEnabled;
} CODEC_ENGINE_CONTEXT, *PCODEC_ENGINE_CONTEXT;
WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_ENGINE_CONTEXT, GetCodecEngineContext)
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT CodecR_EvtAcxAudioEngineRetrieveEngineMixFormat;
NTSTATUS
NTAPI
CodecR_EvtAcxAudioEngineRetrieveEngineMixFormat(
_In_ ACXAUDIOENGINE AudioEngine,
_Out_ ACXDATAFORMAT * Format
)
{
PCODEC_ENGINE_CONTEXT audioEngineCtx;
PAGED_CODE();
audioEngineCtx = GetCodecEngineContext(AudioEngine);
if (!audioEngineCtx->MixFormat)
{
return STATUS_INVALID_DEVICE_STATE;
}
*Format = audioEngineCtx->MixFormat;
return STATUS_SUCCESS;
}
Configuration requise pour ACX
Version ACX minimale : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | acxelements.h |
IRQL | PASSIVE_LEVEL |