다음을 통해 공유


AcxPnpEventCreate 함수(acxevents.h)

AcxPnpEventCreate 함수는 ACXPNPEVENT를 만듭니다.

통사론

NTSTATUS AcxPnpEventCreate(
  WDFDEVICE              Device,
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_PNPEVENT_CONFIG   Config,
  ACXPNPEVENT            *Event
);

매개 변수

Device

새 이벤트와 연결된 기존 WDFDEVICE 개체(Framework 개체요약에 설명됨)입니다.

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

참고 항목