Función NdisAllocateTimerObject (ndis.h)

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