KSPROPERTY_RTAUDIO_CLOCKREGISTER

KSPROPERTY_RTAUDIO_CLOCKREGISTER プロパティは、クライアントがアクセスできる仮想メモリの場所にオーディオ デバイスのウォール クロック レジスタをマップします。

次の表は、このプロパティの機能をまとめたものです。

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	いいえ	ピン留めする	KSRTAUDIO_HWREGISTER_PROPERTY	KSRTAUDIO_HWREGISTER

プロパティ記述子 (インスタンス データ) は、KSPROPERTY 構造体を含む KSRTAUDIO_HWREGISTER_PROPERTY 構造体で構成されます。 クライアントは、要求を送信する前に、クロック レジスタの優先ベース アドレスを示す値を持つ KSRTAUDIO_HWREGISTER_PROPERTY 構造体を読み込みます。

プロパティ値 (操作データ) は、プロパティ ハンドラーがレジスタ アドレスとレジスタ更新頻度を書き込む KSRTAUDIO_HWREGISTER 構造体へのポインターです。 このレジスタ アドレスは、ハードウェア レジスタがマップされるユーザー モードまたはカーネル モードの仮想アドレスです。 クライアントは、このアドレスからレジスタを直接読み取ることができます。

戻り値

KSPROPERTY_RTAUDIO_CLOCKREGISTER プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は失敗を示すエラー コードを返します。

解説

一部のオーディオ デバイスにはクロック レジスタが含まれています。 クロック レジスタは、ハードウェアの電源がオンになったときに実行を開始し、ハードウェアの電源が切れたときに停止するウォール クロック カウンターです。 ソフトウェアは、デバイスのハードウェア クロック間の相対ドリフトを測定することによって、クロック レジスタを使用して 2 つ以上のコントローラー デバイス間で同期します。

成功した場合、プロパティ要求は、クライアントによって指定されたユーザー モードまたはカーネル モードからアクセスできる仮想メモリ アドレスにクロック レジスタをマップします。 その後、クライアントはこのアドレスから読み取り、クロック レジスタの現在の値を取得します。

オーディオ ハードウェアが仮想メモリにマップできるクロック レジスタをサポートしていない場合、プロパティ要求は失敗します。

クロック レジスタのマッピングは、ピンが閉じると破棄されます。 クライアントは、ピン インスタンスの有効期間中に 1 回だけレジスタをマップでき、そのインスタンスのクロック レジスタを再マップする後続の呼び出しは失敗します。

通常、クロック レジスタの読み取りは、ユーザー モード クライアントのユーザー モードとカーネル モードの切り替えを必要とする KSPROPERTY_CLOCK_TIME 要求を送信するよりも高速です。

要件

バージョン	Windows Vista 以降の Windows オペレーティング システムで使用できます。
ヘッダー	Ksmedia.h

関連項目

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER