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) |