EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT回呼函式 (acxelements.h)
驅動程式會實 作EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT回 呼，並在要求指定音訊引擎的內部混合格式時呼叫。
語法
EVT_ACX_AUDIOENGINE_RETRIEVE_ENGINE_FORMAT EvtAcxAudioengineRetrieveEngineFormat;
NTSTATUS EvtAcxAudioengineRetrieveEngineFormat(
ACXAUDIOENGINE AudioEngine,
ACXDATAFORMAT *Format
)
{...}
參數
AudioEngine
已要求混合格式的 ACXAUDIOENGINE 物件。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
Format
描述音訊引擎混合格式的 ACXDATAFORMAT 物件。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
範例
範例使用方式如下所示。
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;
}
ACX 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxelements.h |
| IRQL | PASSIVE_LEVEL |