NdisAllocateTimerObject-Funktion (ndis.h)

Artikel
02/07/2025

Die NdisAllocateTimerObject--Funktion weist ein Timerobjekt für die Verwendung mit nachfolgenden NdisXxx Timerfunktionen zu und initialisiert es.

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 Timerfunktionen zu identifizieren.

Rückgabewert

NdisAllocateTimerObject gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Das Timerobjekt wurde erfolgreich zugewiesen.
NDIS_STATUS_RESOURCES	Fehler bei der Zuordnung aufgrund unzureichender Ressourcen.
NDIS_STATUS_BAD_CHARACTERISTICS	Fehler bei der Zuordnung, da die Informationen in der NDIS_TIMER_CHARACTERISTICS Struktur ungültig sind.
NDIS_STATUS_FAILURE	Es gelten keine der vorherigen Statuswerte.

Bemerkungen

Um Zeitgeberdienste 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.

Rufen Sie zum Starten eines Timers die NdisSetTimerObject--Funktion auf. Aufrufe an NdisSetTimerObject das Timerobjekt in die Systemzeitgeberwarteschlange einfügen. Es kann jeweils nur eine Instanz eines bestimmten Timerobjekts in die Warteschlange gestellt werden.

Rufen Sie zum Abbrechen eines Timers die NdisCancelTimerObject--Funktion auf. NdisCancelTimerObject das Timerobjekt dequeues, wenn es derzeit in die Warteschlange gestellt wird.

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

Anforderungen

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

Siehe auch

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject-

Freigeben über