WdfTimerGetParentObject, fonction (wdftimer.h)
[S’applique à KMDF et UMDF]
La méthode WdfTimerGetParentObject retourne un handle à l’objet parent d’un objet minuteur d’infrastructure spécifié.
Syntaxe
WDFOBJECT WdfTimerGetParentObject(
[in] WDFTIMER Timer
);
Paramètres
[in] Timer
Handle vers un objet de minuteur de framework obtenu en appelant WdfTimerCreate.
Valeur de retour
WdfTimerGetParentObject retourne un handle à l’objet framework qui est l’objet parent de l’objet minuteur spécifié.
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
Pour plus d’informations sur les objets du minuteur de framework, consultez Using Timers.
Exemples
L’exemple de code suivant montre maintenant un EvtTimerFunc fonction de rappel peut obtenir le parent d’un objet minuteur. Dans cet exemple, le pilote a précédemment spécifié que le parent de l’objet minuteur est un objet de file d’attente.
VOID
MyEvtTimerFunc(
IN WDFTIMER Timer
)
{
WDFQUEUE queue;
queue = WdfTimerGetParentObject(Timer);
...
}
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdftimer.h (include Wdf.h) |
| bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf) |