KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

아티클
06/15/2023

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT 속성은 DMA 기반 이벤트 알림에서 사용자 모드 이벤트의 등록을 취소합니다.

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

사용 요약 테이블

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

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

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

반환 값

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

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

설명

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

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

핀을 중지하고 핀을 닫는 단계 이전에 등록된 각 이벤트는 KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT 호출을 통해 등록을 취소해야 합니다.