KSPROPERTY_RTAUDIO_CLOCKREGISTER
La propriété KSPROPERTY_RTAUDIO_CLOCKREGISTER mappe le registre de l’horloge murale du périphérique audio à un emplacement de mémoire virtuelle auquel le client peut accéder.
Le tableau suivant récapitule les fonctionnalités de cette propriété.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Non |
Épingle |
Le descripteur de propriété (instance données) se compose d’une structure KSRTAUDIO_HWREGISTER_PROPERTY qui contient une structure KSPROPERTY. Avant d’envoyer la demande, le client charge la structure KSRTAUDIO_HWREGISTER_PROPERTY avec des valeurs qui indiquent l’adresse de base préférée pour le registre d’horloge.
La valeur de propriété (données d’opération) est un pointeur vers une structure de KSRTAUDIO_HWREGISTER dans laquelle le gestionnaire de propriétés écrit l’adresse de registre et la fréquence register-update. Cette adresse de registre est l’adresse virtuelle en mode utilisateur ou en mode noyau dans laquelle le registre matériel est mappé. Le client peut lire directement le registre à partir de cette adresse.
Valeur de retour
Une demande de propriété KSPROPERTY_RTAUDIO_CLOCKREGISTER retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la demande retourne un code d’erreur qui indique un échec.
Notes
Certains périphériques audio contiennent des registres d’horloge. Un registre d’horloge est un compteur d’horloges murales qui commence à fonctionner lorsque le matériel s’allume et s’arrête lorsque le matériel est hors service. Le logiciel utilise des registres d’horloge pour synchroniser entre deux ou plusieurs appareils de contrôleur en mesurant la dérive relative entre les horloges matérielles de l’appareil.
Si elle réussit, la demande de propriété mappe le registre de l’horloge à une adresse de mémoire virtuelle accessible à partir du mode utilisateur ou du mode noyau, comme spécifié par le client. Par la suite, le client lit à partir de cette adresse pour obtenir la valeur actuelle du registre de l’horloge.
La demande de propriété échoue si le matériel audio ne prend pas en charge un registre d’horloge qui peut être mappé à la mémoire virtuelle.
Le mappage du registre de l’horloge est détruit lorsque l’épingle se ferme. Le client ne peut mapper le registre qu’une seule fois dans la durée de vie d’une épingle instance, et tout appel ultérieur pour mapper le registre de l’horloge pour cette instance échoue.
Il est généralement plus rapide de lire un registre d’horloge que d’envoyer une demande de KSPROPERTY_CLOCK_TIME , ce qui nécessite des transitions entre le mode utilisateur et le mode noyau pour les clients en mode utilisateur.
Spécifications
Version |
Disponible dans les systèmes d’exploitation Windows Vista et ultérieurs. |
En-tête |
Ksmedia.h |