NdisAllocateTimerObject, fonction (ndis.h)
La fonction NdisAllocateTimerObject alloue et initialise un objet minuteur à utiliser avec les fonctions de minuteur NdisXxx suivantes.
Syntaxe
NDIS_STATUS NdisAllocateTimerObject(
[in] NDIS_HANDLE NdisHandle,
[in] PNDIS_TIMER_CHARACTERISTICS TimerCharacteristics,
[out] PNDIS_HANDLE pTimerObject
);
Paramètres
[in] NdisHandle
Handle NDIS obtenu lors de l’initialisation de l’appelant. Pour plus d’informations sur l’obtention de handles NDIS, consultez Obtention de handles de pool.
[in] TimerCharacteristics
Pointeur vers un appelant fourni NDIS_TIMER_CHARACTERISTICS structure qui spécifie les caractéristiques de l’objet minuteur alloué.
[out] pTimerObject
Pointeur vers un handle d’objet du minuteur NDIS fourni par NDIS pour identifier l’objet minuteur dans les appels suivants à Ndisfonctions de minuteur Xxx.
Valeur de retour
NdisAllocateTimerObject retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’objet minuteur a été alloué avec succès. |
|
L’allocation a échoué en raison de ressources insuffisantes. |
|
L’allocation a échoué, car les informations de la structure NDIS_TIMER_CHARACTERISTICS ne sont pas valides. |
|
Aucune des valeurs d’état précédentes ne s’applique. |
Remarques
Pour utiliser les services du minuteur, un pilote NDIS appelle d’abord la fonction NdisAllocateTimerObject pour initialiser un objet minuteur. En règle générale, NdisAllocateTimerObject est appelée lors de l’initialisation du pilote.
Pour démarrer un minuteur, appelez la fonction NdisSetTimerObject. Les appels à NdisSetTimerObject insérer l’objet minuteur dans la file d’attente du minuteur système. Une seule instance d’un objet minuteur particulier peut être mise en file d’attente à un moment donné.
Pour annuler un minuteur, appelez la fonction NdisCancelTimerObject. NdisCancelTimerObject déqueue l’objet minuteur s’il est actuellement mis en file d’attente.
Pour libérer un objet minuteur, vous devez appeler la fonction NdisFreeTimerObject.