Função NdisAllocateTimerObject (ndis.h)

Artigo
02/07/2025

A função NdisAllocateTimerObject aloca e inicializa um objeto de temporizador para uso com funções de temporizador de NdisXxx subsequentes.

Sintaxe

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

Parâmetros

[in] NdisHandle

Um identificador NDIS obtido durante a inicialização do chamador. Para obter mais informações sobre como obter identificadores NDIS, consulte Obtendo identificadores de pool.

[in] TimerCharacteristics

Um ponteiro para um chamador fornecido NDIS_TIMER_CHARACTERISTICS estrutura que especifica as características do objeto de temporizador alocado.

[out] pTimerObject

Um ponteiro para um identificador de objeto de temporizador NDIS que o NDIS fornece para identificar o objeto de temporizador em chamadas subsequentes para Ndisxxx funções de temporizador.

Valor de retorno

NdisAllocateTimerObject retorna um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	O objeto timer foi alocado com êxito.
NDIS_STATUS_RESOURCES	A alocação falhou devido a recursos insuficientes.
NDIS_STATUS_BAD_CHARACTERISTICS	A alocação falhou porque as informações na estrutura NDIS_TIMER_CHARACTERISTICS são inválidas.
NDIS_STATUS_FAILURE	Nenhum dos valores de status anteriores se aplicam.

Observações

Para usar serviços de temporizador, um driver NDIS primeiro chama a função NdisAllocateTimerObject para inicializar um objeto de temporizador. Normalmente, NdisAllocateTimerObject é chamado durante a inicialização do driver.

Para iniciar um temporizador, chame a função NdisSetTimerObject. Chamadas para NdisSetTimerObject inserir o objeto timer na fila do temporizador do sistema. Somente uma instância de um objeto de temporizador específico pode ser enfileirada a qualquer momento.

Para cancelar um temporizador, chame a função NdisCancelTimerObject. NdisCancelTimerObject dequeu o objeto timer se ele estiver na fila no momento.

Para liberar um objeto de temporizador, você deve chamar a função NdisFreeTimerObject.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino	Universal
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	Irql_Timer_Function(ndis)

Consulte também

NDIS_TIMER_CHARACTERISTICS

NdisCancelTimerObject

NdisFreeTimerObject

NdisSetTimerObject

Compartilhar via