KSPROPERTY_RTAUDIO_CLOCKREGISTER

Die KSPROPERTY_RTAUDIO_CLOCKREGISTER-Eigenschaft ordnet das Wanduhrregister des Audiogeräts einem virtuellen Speicherstandort zu, auf den der Client zugreifen kann.

In der folgenden Tabelle sind die Features dieser Eigenschaft zusammengefasst.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Nein	Pin	KSRTAUDIO_HWREGISTER_PROPERTY	KSRTAUDIO_HWREGISTER

Der Eigenschaftsdeskriptor (instance Daten) besteht aus einer KSRTAUDIO_HWREGISTER_PROPERTY-Struktur, die eine KSPROPERTY-Struktur enthält. Vor dem Senden der Anforderung lädt der Client die KSRTAUDIO_HWREGISTER_PROPERTY-Struktur mit Werten, die die bevorzugte Basisadresse für das Uhrenregister angeben.

Der Eigenschaftswert (Vorgangsdaten) ist ein Zeiger auf eine KSRTAUDIO_HWREGISTER Struktur, in die der Eigenschaftenhandler die Registeradresse und die Registeraktualisierungshäufigkeit schreibt. Diese Registeradresse ist die virtuelle Adresse im Benutzermodus oder Kernelmodus, der das Hardwareregister zugeordnet ist. Der Client kann das Register direkt von dieser Adresse lesen.

Rückgabewert

Eine KSPROPERTY_RTAUDIO_CLOCKREGISTER-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen Fehlercode zurück, der auf einen Fehler hinweist.

Bemerkungen

Einige Audiogeräte enthalten Uhrenregister. Ein Uhrenregister ist ein Wanduhrzähler, der ausgeführt wird, wenn die Hardware hochgefahren wird, und stoppt, wenn die Hardware heruntergefahren wird. Software verwendet Uhrenregister, um zwischen zwei oder mehr Controllergeräten zu synchronisieren, indem die relative Drift zwischen den Hardwareuhren des Geräts gemessen wird.

Bei erfolgreicher Ausführung ordnet die Eigenschaftsanforderung das Uhrenregister einer adresse des virtuellen Arbeitsspeichers zu, auf die entweder über den Benutzermodus oder den Kernelmodus zugegriffen werden kann, wie vom Client angegeben. Anschließend liest der Client aus dieser Adresse, um den aktuellen Wert des Uhrenregisters abzurufen.

Die Eigenschaftsanforderung schlägt fehl, wenn die Audiohardware kein Uhrenregister unterstützt, das dem virtuellen Arbeitsspeicher zugeordnet werden kann.

Die Zuordnung des Uhrenregisters wird zerstört, wenn der Pin geschlossen wird. Der Client kann das Register nur einmal in der Lebensdauer einer Anheftung instance zuordnen, und jeder nachfolgende Aufruf zum Erneuten Zuordnen des Uhrenregisters für diese instance schlägt fehl.

Es ist in der Regel schneller, ein Uhrenregister zu lesen, als eine KSPROPERTY_CLOCK_TIME Anforderung zu senden, was für Clients im Benutzermodus Übergänge zwischen Benutzermodus und Kernelmodus erfordert.

Requirements (Anforderungen)

Version	Verfügbar unter Windows Vista und höheren Windows-Betriebssystemen.
Header	Ksmedia.h

Siehe auch

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER