KSPROPERTY_RTAUDIO_CLOCKREGISTER

KSPROPERTY_RTAUDIO_CLOCKREGISTER 속성은 오디오 디바이스의 벽시계 레지스터를 클라이언트가 액세스할 수 있는 가상 메모리 위치에 매핑합니다.

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

사용량 요약 테이블

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

속성 설명자(instance 데이터)는 KSPROPERTY 구조체를 포함하는 KSRTAUDIO_HWREGISTER_PROPERTY 구조체로 구성됩니다. 요청을 보내기 전에 클라이언트는 클록 레지스터의 기본 기본 주소를 나타내는 값으로 KSRTAUDIO_HWREGISTER_PROPERTY 구조를 로드합니다.

속성 값(작업 데이터)은 속성 처리기가 레지스터 주소 및 레지스터 업데이트 빈도를 작성하는 KSRTAUDIO_HWREGISTER 구조체에 대한 포인터입니다. 이 레지스터 주소는 하드웨어 레지스터가 매핑되는 사용자 모드 또는 커널 모드 가상 주소입니다. 클라이언트는 이 주소에서 레지스터를 직접 읽을 수 있습니다.

반환 값

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

설명

일부 오디오 장치에는 클록 레지스터가 포함되어 있습니다. 클록 레지스터는 하드웨어의 전원이 작동할 때 실행이 시작되고 하드웨어의 전원이 닫히면 중지되는 벽시계 카운터입니다. 소프트웨어는 클록 레지스터를 사용하여 디바이스의 하드웨어 클록 간의 상대 드리프트를 측정하여 둘 이상의 컨트롤러 디바이스 간에 동기화합니다.

성공하면 속성 요청은 클라이언트에서 지정한 대로 사용자 모드 또는 커널 모드에서 액세스할 수 있는 가상 메모리 주소에 클록 레지스터를 매핑합니다. 그 후 클라이언트는 이 주소에서 읽어 클록 레지스터의 현재 값을 가져옵니다.

오디오 하드웨어가 가상 메모리에 매핑할 수 있는 클록 레지스터를 지원하지 않으면 속성 요청이 실패합니다.

핀이 닫히면 클록 레지스터의 매핑이 제거됩니다. 클라이언트는 핀 instance 수명 동안 레지스터를 한 번만 매핑할 수 있으며 해당 instance 대해 시계 레지스터를 다시 매핑하는 후속 호출은 실패합니다.

일반적으로 사용자 모드 클라이언트에 대한 사용자 모드와 커널 모드 간의 전환이 필요한 KSPROPERTY_CLOCK_TIME 요청을 보내는 것보다 클록 레지스터를 읽는 것이 더 빠릅니다.

요구 사항

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

참고 항목

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER