NdisAllocateTimerObject-Funktion (ndis.h)
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 |
---|---|
|
Das Timerobjekt wurde erfolgreich zugeordnet. |
|
Fehler bei der Zuordnung aufgrund unzureichender Ressourcen. |
|
Fehler bei der Zuordnung, weil die Informationen in der NDIS_TIMER_CHARACTERISTICS-Struktur ungültig sind. |
|
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) |