EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT funzione di callback (acxelements.h)
Il callback EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT viene implementato dal driver e viene chiamato quando viene richiesto il formato di combinazione interno per il motore audio specificato.
Sintassi
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT EvtAcxAudioengineRetrieveEngineFormat;
NTSTATUS EvtAcxAudioengineRetrieveEngineFormat(
ACXAUDIOENGINE AudioEngine,
ACXDATAFORMAT *Format
)
{...}
Parametri
AudioEngine
Oggetto ACXAUDIOENGINE per il quale è stato richiesto il formato di combinazione. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Format
Oggetto ACXDATAFORMAT che descrive il formato di combinazione del motore audio.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
Di seguito è riportato un esempio di utilizzo.
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;
}
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |