AcxAudioModuleCreate 함수(acxelements.h)
AcxAudioModuleCreate 함수는 ACX 회로 개체 부모에 연결할 오디오 모듈을 만드는 데 사용됩니다.
구문
NTSTATUS AcxAudioModuleCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOMODULE_CONFIG Config,
ACXAUDIOMODULE *AudioModule
);
매개 변수
Object
회로와 연결될 WDFDEVICE 개체( 프레임워크 개체 요약에 설명됨)입니다.
Attributes
다양한 값을 설정하고 오디오 모듈을 ACX 회로 개체와 연결하는 데 사용되는 WDF_OBJECT_ATTRIBUTES 구조를 사용하여 정의된 추가 특성입니다.
Config
오디오 모듈의 구성을 설명하는 초기화된 ACX_AUDIOMODULE_CONFIG 구조 체입니다.
AudioModule
새 ACXMODULE 개체에 대한 핸들을 받는 위치에 대한 포인터입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.
반환 값
호출에 성공하면 를 반환합니다 STATUS_SUCCESS
. 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.
설명
예제
예제 사용법은 다음과 같습니다.
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_AUDIOMODULE_CALLBACKS audioModuleCallbacks;
ACX_AUDIOMODULE_CONFIG audioModuleCfg;
ACXAUDIOMODULE audioModuleElement;
// Now add audio modules to the circuit
// module 0
ACX_AUDIOMODULE_CALLBACKS_INIT(&audioModuleCallbacks);
audioModuleCallbacks.EvtAcxAudioModuleProcessCommand = CodecR_EvtProcessCommand0;
ACX_AUDIOMODULE_CONFIG_INIT(&audioModuleCfg);
audioModuleCfg.Name = &AudioModule0Id;
audioModuleCfg.Descriptor.ClassId = AudioModule0Id;
audioModuleCfg.Descriptor.InstanceId = AUDIOMODULE_INSTANCE_ID(0,0);
audioModuleCfg.Descriptor.VersionMajor = AUDIOMODULE0_MAJOR;
audioModuleCfg.Descriptor.VersionMinor = AUDIOMODULE0_MINOR;
wcsncpy_s(audioModuleCfg.Descriptor.Name,
ACX_AUDIOMODULE_MAX_NAME_CCH_SIZE,
AUDIOMODULE0DESCRIPTION,
wcslen(AUDIOMODULE0DESCRIPTION));
audioModuleCfg.Callbacks = &audioModuleCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_AUDIOMODULE0_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
ACX 요구 사항
최소 ACX 버전: 1.0
ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
헤더 | acxelements.h |
IRQL | PASSIVE_LEVEL |