KSPROPERTY_RTAUDIO_CLOCKREGISTER
KSPROPERTY_RTAUDIO_CLOCKREGISTER プロパティは、クライアントがアクセスできる仮想メモリの場所にオーディオ デバイスのウォール クロック レジスタをマップします。
次の表は、このプロパティの機能をまとめたものです。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
いいえ |
ピン留めする |
プロパティ記述子 (インスタンス データ) は、KSPROPERTY 構造体を含む KSRTAUDIO_HWREGISTER_PROPERTY 構造体で構成されます。 クライアントは、要求を送信する前に、クロック レジスタの優先ベース アドレスを示す値を持つ KSRTAUDIO_HWREGISTER_PROPERTY 構造体を読み込みます。
プロパティ値 (操作データ) は、プロパティ ハンドラーがレジスタ アドレスとレジスタ更新頻度を書き込む KSRTAUDIO_HWREGISTER 構造体へのポインターです。 このレジスタ アドレスは、ハードウェア レジスタがマップされるユーザー モードまたはカーネル モードの仮想アドレスです。 クライアントは、このアドレスからレジスタを直接読み取ることができます。
戻り値
KSPROPERTY_RTAUDIO_CLOCKREGISTER プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は失敗を示すエラー コードを返します。
解説
一部のオーディオ デバイスにはクロック レジスタが含まれています。 クロック レジスタは、ハードウェアの電源がオンになったときに実行を開始し、ハードウェアの電源が切れたときに停止するウォール クロック カウンターです。 ソフトウェアは、デバイスのハードウェア クロック間の相対ドリフトを測定することによって、クロック レジスタを使用して 2 つ以上のコントローラー デバイス間で同期します。
成功した場合、プロパティ要求は、クライアントによって指定されたユーザー モードまたはカーネル モードからアクセスできる仮想メモリ アドレスにクロック レジスタをマップします。 その後、クライアントはこのアドレスから読み取り、クロック レジスタの現在の値を取得します。
オーディオ ハードウェアが仮想メモリにマップできるクロック レジスタをサポートしていない場合、プロパティ要求は失敗します。
クロック レジスタのマッピングは、ピンが閉じると破棄されます。 クライアントは、ピン インスタンスの有効期間中に 1 回だけレジスタをマップでき、そのインスタンスのクロック レジスタを再マップする後続の呼び出しは失敗します。
通常、クロック レジスタの読み取りは、ユーザー モード クライアントのユーザー モードとカーネル モードの切り替えを必要とする KSPROPERTY_CLOCK_TIME 要求を送信するよりも高速です。
要件
バージョン |
Windows Vista 以降の Windows オペレーティング システムで使用できます。 |
ヘッダー |
Ksmedia.h |