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

추가 정보