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

La méthode KsGetResolution récupère la résolution d’horloge 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 retournée

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ément 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 grands. 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 grands 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 d’horloge.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ksproxy.h (inclure Ksproxy.h)

Voir aussi

KSPROPERTY_CLOCK_RESOLUTION

KSRESOLUTION