Funzione NdisAllocateTimerObject (ndis.h)

Articolo
03/05/2024

La funzione NdisAllocateTimerObject alloca e inizializza un oggetto timer da utilizzare con le successive funzioni timer NdisXxx .

Sintassi

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

Parametri

[in] NdisHandle

Handle NDIS ottenuto durante l'inizializzazione del chiamante. Per altre informazioni su come ottenere handle NDIS, vedere Recupero di handle del pool.

[in] TimerCharacteristics

Puntatore a un chiamante fornito NDIS_TIMER_CHARACTERISTICS struttura che specifica le caratteristiche dell'oggetto timer allocato.

[out] pTimerObject

Puntatore a un handle di oggetto timer NDIS fornito da NDIS per identificare l'oggetto timer nelle chiamate successive alle funzioni timer NdisXxx .

Valore restituito

NdisAllocateTimerObject restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	L'oggetto timer è stato allocato correttamente.
NDIS_STATUS_RESOURCES	L'allocazione non è riuscita a causa di risorse insufficienti.
NDIS_STATUS_BAD_CHARACTERISTICS	L'allocazione non è riuscita perché le informazioni nella struttura NDIS_TIMER_CHARACTERISTICS non sono valide.
NDIS_STATUS_FAILURE	Non si applicano nessuno dei valori di stato precedenti.

Commenti

Per usare i servizi timer, un driver NDIS chiama innanzitutto la funzione NdisAllocateTimerObject per inizializzare un oggetto timer. In genere , NdisAllocateTimerObject viene chiamato durante l'inizializzazione del driver.

Per avviare un timer, chiamare la funzione NdisSetTimerObject . Le chiamate a NdisSetTimerObject inseriscono l'oggetto timer nella coda del timer di sistema. Una sola istanza di un particolare oggetto timer può essere accodata in qualsiasi momento.

Per annullare un timer, chiamare la funzione NdisCancelTimerObject . NdisCancelTimerObject rimuove dalla coda l'oggetto timer se è attualmente in coda.

Per liberare un oggetto timer, è necessario chiamare la funzione NdisFreeTimerObject .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Timer_Function(ndis)

Vedi anche

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject

Condividi tramite