KSPROPERTY_RTAUDIO_CLOCKREGISTER

KSPROPERTY_RTAUDIO_CLOCKREGISTER 屬性會將音訊裝置的時鐘暫存器對應到用戶端可以存取的虛擬記憶體位置。

下表摘要說明此屬性的功能。

Get	集合	目標	屬性描述項類型	屬性值類型
是	否	Pin	KSRTAUDIO_HWREGISTER_PROPERTY	KSRTAUDIO_HWREGISTER

屬性描述項 (實例資料) 是由包含 KSPROPERTY 結構的KSRTAUDIO_HWREGISTER_PROPERTY結構所組成。傳送要求之前，用戶端會載入KSRTAUDIO_HWREGISTER_PROPERTY結構，其中包含指出時鐘暫存器慣用基底位址的值。

屬性值 (作業資料) 是屬性處理常式寫入暫存器位址和暫存器更新頻率之KSRTAUDIO_HWREGISTER結構的指標。此登入位址是硬體暫存器對應的使用者模式或核心模式虛擬位址。用戶端可以直接從這個位址讀取暫存器。

KSPROPERTY_RTAUDIO_CLOCKREGISTER屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。否則，要求會傳回錯誤碼，指出失敗。

備註

某些音訊裝置包含時鐘暫存器。時鐘暫存器是時鐘計數器，會在硬體開機時開始執行，並在硬體關閉時停止。軟體會使用時鐘暫存器，藉由測量裝置硬體時鐘之間的相對漂移，在兩個或多個控制器裝置之間進行同步處理。

如果成功，屬性要求會將時鐘暫存器對應至可從使用者模式或核心模式存取的虛擬記憶體位址，如用戶端所指定。之後，用戶端會從這個位址讀取，以取得時鐘暫存器目前的值。

如果音訊硬體不支援可對應至虛擬記憶體的時鐘暫存器，屬性要求就會失敗。

當針腳關閉時，時鐘暫存器的對應會終結。用戶端只能在 pin 實例的存留期內對應暫存器一次，而任何後續呼叫來對應該實例的時鐘暫存器會失敗。

讀取時鐘暫存器的速度通常比傳送 KSPROPERTY_CLOCK_TIME 要求更快，這需要使用者模式用戶端的使用者模式與核心模式之間的轉換。

版本	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭	Ksmedia.h