Fonction NdisAllocateTimerObject (ndis.h)

  • Article

La fonction NdisAllocateTimerObject alloue et initialise un objet de minuteur à utiliser avec les fonctions de minuterie NdisXxx suivantes.

Syntaxe

NDIS_STATUS NdisAllocateTimerObject(
  [in]  NDIS_HANDLE                 NdisHandle,
  [in]  PNDIS_TIMER_CHARACTERISTICS TimerCharacteristics,
  [out] PNDIS_HANDLE                pTimerObject
);

Paramètres

[in] NdisHandle

Un 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 minuteur NDIS fourni par NDIS pour identifier l’objet minuteur dans les appels suivants aux fonctions du minuteur NdisXxx .

Valeur retournée

NdisAllocateTimerObject retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS
 L’objet minuteur a été alloué avec succès.
NDIS_STATUS_RESOURCES
 L’allocation a échoué en raison de ressources insuffisantes.
NDIS_STATUS_BAD_CHARACTERISTICS
 L’allocation a échoué, car les informations de la structure NDIS_TIMER_CHARACTERISTICS ne sont pas valides.
NDIS_STATUS_FAILURE
 Aucune des valeurs status 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é lors de l’initialisation du pilote.

Pour démarrer un minuteur, appelez la fonction NdisSetTimerObject . Les appels à NdisSetTimerObject insèrent l’objet minuteur dans la file d’attente du minuteur système. Une seule instance d’un objet de minuteur particulier peut être mise en file d’attente à un moment donné.

Pour annuler un minuteur, appelez la fonction NdisCancelTimerObject . NdisCancelTimerObject supprime la file d’attente de l’objet du minuteur s’il est actuellement mis en file d’attente.

Pour libérer un objet minuteur, vous devez appeler la fonction NdisFreeTimerObject .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible Universal
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_Timer_Function(ndis)

Voir aussi

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject