AcxPnpEventCreate 함수(acxevents.h)
AcxPnpEventCreate 함수는 ACXPNPEVENT를 만듭니다.
구문
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
매개 변수
Device
새 이벤트와 연결된 기존 WDFDEVICE 개체( 프레임워크 개체 요약에 설명됨)입니다.
Object
이벤트와 연결될 ACX 개체 요약 에 설명된 기존 ACXAUDIOMODULE 개체입니다.
Attributes
다양한 개체의 값을 설정하는 데 사용되는 WDF_OBJECT_ATTRIBUTES 사용하여 정의된 추가 특성: 콜백 정리 및 삭제, 컨텍스트 형식 및 부모 개체를 지정합니다.
Config
ACX PNP 이벤트에 대한 구성을 정의하는 ACX_PNPEVENT_CONFIG 구조체입니다.
Event
ACXEVENT 개체( ACX 개체 요약에 설명됨).
반환 값
호출이 성공하면 를 반환합니다 STATUS_SUCCESS
. 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.
설명
ACXPNPEVENT는 드라이버 수준에서 사용할 수 있는 비동기 알림을 나타냅니다. PNP 이벤트는 모든 개체에 추가할 수 있습니다. 현재 ACXAUDIOMODULE 및 ACXKEYWARDSPOTTER 개체와 함께 사용됩니다. 내부적으로 AcxPnpEvents는 상위 계층에 PNP 비동기 알림으로 노출됩니다.
예제
이 예제 코드에서는 AcxPnpEventCreate를 사용하는 방법을 보여 있습니다.
NTSTATUS status;
ACXAUDIOMODULE audioModuleElement;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_PNPEVENT_CONFIG audioModuleEventCfg;
ACXPNPEVENT audioModuleEvent;
...
status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
audioModule0Ctx = GetCodecAudioModule0Context(audioModuleElement);
ACX_PNPEVENT_CONFIG_INIT(&audioModuleEventCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PNPEVENT_CONTEXT);
attributes.ParentObject = audioModuleElement;
status = AcxPnpEventCreate(Device, audioModuleElement, &attributes, &audioModuleEventCfg, &audioModuleEvent);
ACX 요구 사항
최소 ACX 버전: 1.0
ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
헤더 | acxevents.h |
IRQL | PASSIVE_LEVEL |