Fonction de rappel PFNKSSETTIMER (ks.h)

Article
02/26/2024

La routine KStrSetTimer d’un minidriver de streaming est appelée pour générer des rappels du minuteur DPC en fonction de l’heure de présentation.

Syntaxe

PFNKSSETTIMER Pfnkssettimer;

BOOLEAN Pfnkssettimer(
  [in] PVOID Context,
  [in] PKTIMER Timer,
  [in] LARGE_INTEGER DueTime,
  [in] PKDPC Dpc
)
{...}

Paramètres

[in] Context

Pointeur vers le contexte d’informations fourni par le minidriver. Le minidriver transmet le contexte d’informations à KsAllocateDefaultClockEx dans le paramètre DeferredContext de la fonction lorsque le minidriver alloue un objet de minuteur DPC personnalisé.

[in] Timer

Pointeur vers un objet minuteur alloué par le minidriver.

[in] DueTime

Spécifie l’heure absolue ou relative à laquelle le minuteur doit expirer. Si la valeur du paramètre DueTime est négative, l’heure d’expiration est relative à l’heure système actuelle. Sinon, le délai d’expiration est absolu. Le temps d’expiration est exprimé en unités de temps système (intervalles de 100 nanosecondes). Les heures d’expiration absolues suivent les modifications apportées à l’heure système ; les heures d’expiration relatives ne sont pas affectées par les changements d’heure système.

[in] Dpc

Pointeur vers un objet DPC initialisé par le minidriver à l’aide de KeInitializeDpc. Ce paramètre est facultatif.

Valeur renvoyée

Retourne TRUE si l’objet minuteur se trouvait déjà dans la file d’attente du minuteur système. Sinon, retourne FALSE.

Remarques

Les mini-disques peuvent éventuellement fournir une fonction de rappel KStrSetTimer comme argument à KsAllocateDefaultClockEx.

En règle générale, si un minidriver fournit une fonction de rappel KStrCorrelatedTime , le minidriver fournit également une fonction de rappel KStrSetTimer .

Si les mini-disques fournissent une fonction de rappel KStrSetTimer , la fonction doit définir les minuteurs, en fonction des deltas, sur l’heure de présentation actuelle afin de générer des notifications d’événements.

Si un minidriver fournit une fonction de rappel KStrSetTimer , le minidriver doit également fournir une fonction de rappel KStrCancelTimer pour annuler le minuteur.

Le minidriver fourni par KStrSetTimer doit avoir les mêmes caractéristiques que KeSetTimerEx.