NdisAllocateTimerObject-Funktion (ndis.h)

Artikel
08/07/2023

Die NdisAllocateTimerObject-Funktion ordnet und initialisiert ein Timerobjekt zur Verwendung mit nachfolgenden NdisXxx-Zeitgeberfunktionen .

Syntax

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

Parameter

[in] NdisHandle

Ein NDIS-Handle, das während der Initialisierung des Aufrufers abgerufen wurde. Weitere Informationen zum Abrufen von NDIS-Handles finden Sie unter Abrufen von Poolhandles.

[in] TimerCharacteristics

Ein Zeiger auf einen vom Aufrufer bereitgestellten NDIS_TIMER_CHARACTERISTICS Struktur, die die Merkmale des zugeordneten Timerobjekts angibt.

[out] pTimerObject

Ein Zeiger auf ein NDIS-Timerobjekthandle, das NDIS bereitstellt, um das Timerobjekt in nachfolgenden Aufrufen von NdisXxx-Zeitgeberfunktionen zu identifizieren.

Rückgabewert

NdisAllocateTimerObject gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Das Timerobjekt wurde erfolgreich zugeordnet.
NDIS_STATUS_RESOURCES	Fehler bei der Zuordnung aufgrund unzureichender Ressourcen.
NDIS_STATUS_BAD_CHARACTERISTICS	Fehler bei der Zuordnung, weil die Informationen in der NDIS_TIMER_CHARACTERISTICS-Struktur ungültig sind.
NDIS_STATUS_FAILURE	Keiner der oben genannten status Werte gilt.

Hinweise

Um Timerdienste zu verwenden, ruft ein NDIS-Treiber zuerst die NdisAllocateTimerObject-Funktion auf, um ein Timerobjekt zu initialisieren. In der Regel wird NdisAllocateTimerObject während der Treiberinitialisierung aufgerufen.

Um einen Timer zu starten, rufen Sie die NdisSetTimerObject-Funktion auf. Aufrufe von NdisSetTimerObject fügen das Timerobjekt in die Systemtimerwarteschlange ein. Nur eine instance eines bestimmten Timerobjekts kann zu einem bestimmten Zeitpunkt in die Warteschlange eingereiht werden.

Um einen Timer abzubrechen, rufen Sie die Funktion NdisCancelTimerObject auf . NdisCancelTimerObject entfernt die Warteschlange für das Timerobjekt, wenn es sich derzeit in der Warteschlange befindet.

Zum Freigeben eines Timerobjekts müssen Sie die NdisFreeTimerObject-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_Timer_Function(ndis)

Weitere Informationen

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject

Freigeben über