Fonction de rappel PFNKSSETTIMER (ks.h)
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 minidriver. Le minidriver transmet le contexte d’informations à KsAllocateDefaultClockEx dans le paramètre DeferredContext de la fonction lorsque le minidriver alloue un objet 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 temps 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 modifications de temps système.
[in] Dpc
Pointeur vers un objet DPC initialisé à l’aide de KeInitializeDpc. Ce paramètre est facultatif.
Valeur de retour
Retourne TRUE si l’objet minuteur était déjà dans la file d’attente du minuteur système. Sinon, retourne FALSE.
Remarques
Les minidrivers peuvent éventuellement fournir une fonction de rappel KStrSetTimer en tant qu’argument pour KsAllocateDefaultClockEx.
En règle générale, si un minidriver fournit une fonction de rappel KStrCorrelatedTime, le minidriver fournit également un KStrSetTimer fonction de rappel.
Si les minidrivers fournissent un KStrSetTimer fonction de rappel, la fonction doit définir des 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 un KStrCancelTimer fonction de rappel pour annuler le minuteur.
Le minidriver fourni KStrSetTimer doit avoir les mêmes caractéristiques que KeSetTimerEx.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | ks.h (include Ks.h) |