IMiniportWaveRTStreamNotification::RegisterNotificationEvent 메서드(portcls.h)

메서드는 RegisterNotificationEvent DMA 기반 이벤트 알림에 대한 알림을 받을 이벤트를 등록합니다.

구문

NTSTATUS RegisterNotificationEvent(
  [in] PKEVENT NotificationEvent
);

매개 변수

[in] NotificationEvent

DMA가 진행됨에 따라 알림을 위해 등록할 커널 이벤트(PKEVENT)에 대한 포인터입니다.

반환 값

RegisterNotificationEvent는 호출에 성공하면 STATUS_SUCCESS 상태 값을 반환합니다. 그렇지 않으면 메서드가 적절한 오류 상태 코드를 반환합니다.

설명

포트 드라이버는 클라이언트의 KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 속성 요청에 대한 응답으로 이 메서드를 호출합니다. 포트 드라이버는 사용자 모드 이벤트 핸들을 커널 이벤트 포인터에 매핑하고 NotificationEvent 매개 변수를 사용하여 포인터를 전달합니다.

일반적으로 DMA 기반 이벤트 알림을 사용하도록 설정하면 DMA 하드웨어는 순환 오디오 버퍼의 의도된 알림 지점에서 하드웨어 인터럽트 생성을 프로그래밍합니다. 드라이버 ISR(인터럽트 서비스 루틴)이 이 인터럽트(인터럽트)를 감지하면 DPC(지연 프로시저 호출)를 큐에 대기합니다. DPC는 등록된 각 이벤트에 신호를 보냅니다. 호출을 알리는 이벤트 주위에 try/except 구문을 사용하는 것이 좋습니다.

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 속성의 동작에 대한 자세한 내용은 KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY 참조하세요.

요구 사항

추가 정보

IMiniportWaveRTStreamNotification

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY