KSPROPERTY_RTAUDIO_CLOCKREGISTER

La proprietà KSPROPERTY_RTAUDIO_CLOCKREGISTER esegue il mapping del registro dell'orologio a parete del dispositivo audio in una posizione di memoria virtuale a cui è possibile accedere il client.

Nella tabella seguente vengono riepilogate le funzionalità di questa proprietà.

Tabella riepilogo utilizzo

Recupero	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo di valore della proprietà
Sì	No	Aggiungi (Blocca)	KSRTAUDIO_HWREGISTER_PROPERTY	KSRTAUDIO_HWREGISTER

Il descrittore di proprietà (dati dell'istanza) è costituito da una struttura KSRTAUDIO_HWREGISTER_PROPERTY che contiene una struttura KSPROPERTY . Prima di inviare la richiesta, il client carica la struttura KSRTAUDIO_HWREGISTER_PROPERTY con valori che indicano l'indirizzo di base preferito per il registro orologio.

Il valore della proprietà (dati dell'operazione) è un puntatore a una struttura KSRTAUDIO_HWREGISTER in cui il gestore della proprietà scrive l'indirizzo del registro e la frequenza di aggiornamento del registro. Questo indirizzo di registrazione è l'indirizzo virtuale in modalità utente o in modalità kernel in cui viene mappato il registro hardware. Il client può leggere direttamente il registro da questo indirizzo.

Valore restituito

Una richiesta di proprietà KSPROPERTY_RTAUDIO_CLOCKREGISTER restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di errore che indica un errore.

Commenti

Alcuni dispositivi audio contengono registri dell'orologio. Un registro orologio è un contatore dell'orologio a parete che inizia a funzionare quando l'hardware è attivo e si arresta quando l'hardware è inattivo. Il software usa i registri dell'orologio per sincronizzare tra due o più dispositivi controller misurando la deriva relativa tra gli orologi hardware del dispositivo.

Se ha esito positivo, la richiesta di proprietà esegue il mapping dell'orologio a un indirizzo di memoria virtuale accessibile dalla modalità utente o dalla modalità kernel, come specificato dal client. Successivamente, il client legge da questo indirizzo per ottenere il valore corrente del registro dell'orologio.

La richiesta di proprietà ha esito negativo se l'hardware audio non supporta un registro orologio che può essere mappato alla memoria virtuale.

Il mapping del registro dell'orologio viene distrutto quando il pin viene chiuso. Il client può eseguire il mapping del registro una sola volta alla durata di un'istanza di pin e qualsiasi chiamata successiva per eseguire nuovamente il mapping del registro dell'orologio per tale istanza ha esito negativo.

In genere è più veloce leggere un registro di orologio che inviare una richiesta di KSPROPERTY_CLOCK_TIME , che richiede transizioni tra la modalità utente e la modalità kernel per i client in modalità utente.

Requisiti

Versione	Disponibile in Windows Vista e nei sistemi operativi Windows successivi.
Intestazione	Ksmedia.h

Vedere anche

KSRTAUDIO_HWREGISTER_PROPERTY

KSRTAUDIO_HWREGISTER