Partager via


IKsClockPropertySet ::KsGetResolution, méthode (ksproxy.h)

La méthode KsGetResolution récupère la résolution de l’horloge à partir de l’horloge sous-jacente.

Syntaxe

HRESULT KsGetResolution(
  [out] KSRESOLUTION *Resolution
);

Paramètres

[out] Resolution

Pointeur vers une variable qui reçoit une structure KSRESOLUTION qui contient la granularité et l’erreur de l’horloge sous-jacente.

Valeur de retour

Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

La méthode KsGetResolution récupère la propriété de résolution de l’horloge sous-jacente, qui spécifie la granularité d’incrémentation et l’erreur de notification de l’horloge sous-jacente en termes d’unités de 100 nanosecondes. La meilleure granularité serait une unité de 100 nanosecondes ; les incréments moins granulaires contiennent des nombres plus importants. La quantité minimale d’erreur de notification au-dessus et au-delà de la granularité d’horloge serait signalée comme zéro unité de 100 nanosecondes, et les horloges moins précises utiliseraient des nombres plus importants pour indiquer l’erreur +/−. Le proxy peut utiliser cette propriété de résolution pour déterminer le nombre maximal d’erreurs et de résolution dans la notification et la synchronisation des événements.

Le proxy utilise la propriété KSPROPERTY_CLOCK_RESOLUTION pour récupérer la résolution de l’horloge.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête ksproxy.h (include Ksproxy.h)

Voir aussi

KSPROPERTY_CLOCK_RESOLUTION

KSRESOLUTION