KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

아티클
06/15/2023

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 속성은 DMA 기반 이벤트 알림에 대한 사용자 모드 이벤트를 등록합니다. KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 성공적으로 호출한 후 이벤트를 등록해야 합니다.

다음 표에는 이 속성의 기능이 요약되어 있습니다.

사용량 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
Yes	Yes	Pin	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

속성 설명자(instance 데이터)는 KSPROPERTY 구조와 사용자 모드 이벤트 핸들을 포함하는 KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY 구조로 구성됩니다.

작업 데이터가 반환되지 않으므로 이 속성의 속성 값(작업 데이터)은 NULL 입니다.

반환 값

KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 코드에 상태 적절한 오류를 반환합니다. 다음 표에서는 코드에 상태 가능한 오류 중 일부를 보여 줍니다.

상태 코드	의미
STATUS_NOT_SUPPORTED	이벤트 알림은 지원되지 않습니다.
STATUS_INSUFFICIENT_RESOURCES	버퍼의 메모리를 할당할 수 없습니다.
STATUS_DEVICE_NOT_READY	디바이스가 준비되지 않았습니다.

설명

이 속성은 DMA 기반 이벤트 알림에 대한 사용자 모드 이벤트를 등록하는 데 사용됩니다.

핀이 실행 상태(KSSTATE_RUN)에 배치되면 등록된 이벤트는 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 호출될 때 요청된 알림 수에 따라 순환 오디오 버퍼의 주기당 한두 번 신호를 받습니다. KSSTATERUN에 대한 자세한 내용은 상태 전환 항목을 참조하세요.

핀을 중지한 후 핀을 닫기 전에 등록된 각 이벤트는 KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT 호출을 통해 등록 취소됩니다.