Funzione NdisAllocateTimerObject (ndis.h)

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

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 sull'acquisizione degli 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 dell'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
Nessuno dei valori di stato precedenti si applica.

Commenti

Per usare i servizi timer, un driver NDIS chiama prima 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 timer di sistema. Solo un'istanza di un particolare oggetto timer può essere accodata in qualsiasi momento.

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

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

Requisiti

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

Vedi anche

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject