Función NdisAllocateTimerObject (ndis.h)

  • Artículo

La función NdisAllocateTimerObject asigna e inicializa un objeto de temporizador para su uso con las funciones posteriores del temporizador NdisXxx .

Sintaxis

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

Parámetros

[in] NdisHandle

Identificador NDIS que se obtuvo durante la inicialización del autor de la llamada. Para obtener más información sobre cómo obtener identificadores NDIS, consulte Obtención de identificadores de grupo.

[in] TimerCharacteristics

Puntero a un autor de llamada proporcionado NDIS_TIMER_CHARACTERISTICS estructura que especifica las características del objeto de temporizador asignado.

[out] pTimerObject

Puntero a un identificador de objeto de temporizador NDIS que NDIS proporciona para identificar el objeto del temporizador en llamadas posteriores a las funciones del temporizador NdisXxx .

Valor devuelto

NdisAllocateTimerObject devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 El objeto de temporizador se asignó correctamente.
NDIS_STATUS_RESOURCES
 Error en la asignación debido a recursos insuficientes.
NDIS_STATUS_BAD_CHARACTERISTICS
 Error en la asignación porque la información de la estructura NDIS_TIMER_CHARACTERISTICS no es válida.
NDIS_STATUS_FAILURE
 No se aplica ninguno de los valores de estado anteriores.

Comentarios

Para usar los servicios de temporizador, un controlador NDIS llama primero a la función NdisAllocateTimerObject para inicializar un objeto de temporizador. Normalmente, se llama a NdisAllocateTimerObject durante la inicialización del controlador.

Para iniciar un temporizador, llame a la función NdisSetTimerObject . Las llamadas a NdisSetTimerObject insertan el objeto de temporizador en la cola del temporizador del sistema. Solo se puede poner en cola una instancia de un objeto de temporizador determinado en cualquier momento dado.

Para cancelar un temporizador, llame a la función NdisCancelTimerObject . NdisCancelTimerObject pone en cola el objeto de temporizador si está actualmente en cola.

Para liberar un objeto de temporizador, debe llamar a la función NdisFreeTimerObject .

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI Irql_Timer_Function(ndis)

Consulte también

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject