KSEVENT_PINCAPS_FORMATCHANGE

아티클
03/08/2023

이벤트는 KSEVENT_PINCAPS_FORMATCHANGE 오디오 디바이스의 오디오 데이터 형식이 변경되었음을 오디오 스택에 나타냅니다.

사용량 요약 테이블

대상	이벤트 설명자 유형	이벤트 값 형식
Pin	KSEVENT	KSEVENTDATA

이벤트 값 형식(작업 데이터)은 이 이벤트에 사용할 알림 방법을 지정하는 KSEVENTDATA 구조체입니다.

설명

오디오 포트 드라이버가 미니포트 드라이버에 대해 EventHandler 루틴을 호출하면 PCEVENT_REQUEST 구조를 전달합니다. 이 구조체에는 필터, 핀 또는 노드에서 지원하는 이벤트를 설명하는 데 사용되는 PCEVENT_ITEM 구조체에 대한 포인터가 포함되어 있습니다.

예를 들어 이벤트를 지원하는 KSEVENT_PINCAPS_FORMATCHANGE 드라이버는 다음과 같이 PCEVENT_ITEM 구조를 채워야 합니다.

static PCEVENT_ITEM FormatChangePinEvent[] = {
  {
    &KSEVENTSETID_PinCapsChange,
    KSEVENT_PINCAPS_FORMATCHANGE,
    KSEVENT_TYPE_ENABLE | KSEVENT_TYPE_BASICSUPPORT,
    MyEventHandler
  }
};

앞의 코드 예제에서 MyEventHandler 사용자 지정 이벤트 처리기는 이벤트를 모니터링하고 KSEVENT_PINCAPS_FORMATCHANGE KSEVENT_PINCAPS_FORMATCHANGE 트리거될 때 Portcls에 등록해야 합니다. 미니포트 드라이버는 IPortEvents::AddEventToEventList 메서드를 호출하여 이벤트를 등록해야 합니다.

미니포트 드라이버에서 지원하는 핀, 노드, 연결 및 속성에 대한 설명을 얻기 위해 포트 드라이버는 IMiniport::GetDescription 메서드를 호출합니다. 이 메서드 호출은 자동화 테이블( PCAUTOMATION_TABLE )을 가리키는 PCFILTER_DESCRIPTOR 구조를 반환합니다. PCAUTOMATION_TABLE 구조에는 이벤트 멤버가 있습니다. 이 멤버는 미니포트 드라이버가 지원하는 필터와 연결된 이벤트 배열을 가리킵니다. 따라서 이벤트에 대한 PCEVENT_ITEM 구조가 포함된 이벤트 배열을 가리키도록 이벤트 멤버를 KSEVENT_PINCAPS_FORMATCHANGE 설정해야 합니다.

미니포트 드라이버가 동적 형식 변경을 감지하면 IPortEvents::GenerateEventList 메서드를 호출하여 이벤트에 신호를 KSEVENT_PINCAPS_FORMATCHANGE 보내야 합니다.