KSPROPERTY_RTAUDIO_GETREADPACKET

KSPROPERTY_RTAUDIO_GETREADPACKET 캡처된 오디오 패킷에 대한 정보를 반환합니다.

사용량 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
Yes	아니요	Pin	KSPROPERTY	KSRTAUDIO_GETREADPACKET_INFO

속성 설명자(instance 데이터)는 KSPROPERTY 구조체입니다. 요청을 보내기 전에 클라이언트는 패킷 번호, 패킷 길이 및 기타 정보를 나타내는 값으로 구조를 로드합니다.

속성 값은 KSRTAUDIO_GETREADPACKET_INFO 형식의 변수입니다.

반환 값

KSPROPERTY_RTAUDIO_GETREADPACKET 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 코드에 상태 적절한 오류를 반환합니다.

STATUS_DEVICE_NOT_READY - 새 데이터를 사용할 수 없는 경우 드라이버가 이 오류를 반환합니다.

설명

WaveRT 버퍼에서 캡처된 오디오 데이터를 읽기 전에 OS는 이 루틴을 호출하여 사용 가능한 데이터에 대한 정보를 가져옵니다.

패킷 번호는 스트림 내의 패킷을 식별합니다. 스트림이 KSSTATE_STOP 있을 때 0으로 다시 설정됩니다. 캡처된 각 버퍼로 숫자가 진행됩니다. 패킷 번호에서 OS는 WaveRT 버퍼 내에서 패킷 위치를 파생시킬 수 있으며 스트림 시작을 기준으로 패킷의 스트림 위치를 파생시킬 수도 있습니다.

패킷 크기는 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 전달된 NotificationCount로 나눈 WaveRT 버퍼 크기입니다. OS는 언제든지 이 루틴을 호출할 수 있습니다. 정상 작업에서 OS는 드라이버가 버퍼 알림 이벤트를 설정한 후 또는 이전 호출이 MoreData에 대해 true를 반환한 후 이 루틴을 호출합니다. OS가 이 루틴을 호출할 때 드라이버는 OS가 이전의 모든 패킷 읽기를 완료한 것으로 가정할 수 있습니다. 하드웨어가 충분한 데이터를 캡처한 경우 드라이버는 즉시 다음 전체 패킷을 WaveRT 버퍼로 버스트하고 버퍼 이벤트를 다시 설정할 수 있습니다. 캡처 오버플로의 경우(OS가 데이터를 충분히 빨리 읽지 못하는 경우) 오디오 드라이버가 일부 오디오 데이터를 삭제하거나 덮어쓸 수 있습니다. 오디오 드라이버는 가장 오래된 데이터를 먼저 삭제하거나 덮어씁니다. 오디오 드라이버는 OS가 데이터를 읽지 못하더라도 내부 패킷 카운터를 계속 진행할 수 있습니다.

요구 사항

Version	Windows 10 이상 Windows 운영 체제에서 사용할 수 있습니다.
헤더	Ksmedia.h

참고 항목

KSPROPERTY_RTAUDIO_SETWRITEPACKET

UsePositionLock