Função StorPortRequestTimer (storport.h)

Artigo
02/07/2025

Agenda um evento de retorno de chamada para um objeto de contexto do temporizador storport.

Sintaxe

ULONG StorPortRequestTimer(
  [in]           PVOID        HwDeviceExtension,
  [in]           PVOID        TimerHandle,
  [in]           PHW_TIMER_EX TimerCallback,
  [in, optional] PVOID        CallbackContext,
  [in]           ULONGLONG    TimerValue,
  [in]           ULONGLONG    TolerableDelay
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in] TimerHandle

Um ponteiro para um buffer opaco para o contexto de temporizador retornado por StorPortInitializeTimer.

[in] TimerCallback

Um ponteiro para uma rotina de retorno de chamada de temporizador fornecida pelo miniporto. Veja a seguir o protótipo definido para PHW_TIMER_EX:

typedef
VOID
(*PHW_TIMER_EX) (
  _In_ PVOID  DeviceExtension,
  _In_opt_ PVOID Context
  );

[in, optional] CallbackContext

Um ponteiro para um miniporto fornecido contexto para o retorno de chamada do temporizador.

[in] TimerValue

O valor de tempo limite para o temporizador, em microssegundos. A configuração TimerValue como 0 cancelará o temporizador.

[in] TolerableDelay

O atraso permitido para o temporizador em microssegundos. Valores inferiores a 32 microssegundos são ignorados e TolerableDelay padrão como 0.

Valor de retorno

A rotina StorPortRequestTimer retorna um destes códigos de status:

Código de retorno	Descrição
STOR_STATUS_INSUFFICIENT_RESOURCES	Não há recursos suficientes disponíveis para adiar o agendamento do temporizador.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, TimerHandleou TimerCallback é NULL. O objeto de contexto do temporizador, TimerHandle, é inválido.
STOR_STATUS_BUSY	Uma solicitação de temporizador anterior está ativa. TimerValue > 0 e TimerCallback não foi chamado.
STOR_STATUS_SUCCESS	A solicitação do temporizador foi agendada com êxito.

Observações

A rotina de StorPortRequestTimer é chamada em qualquer IRQL. No entanto, se a rotina for chamada quando IRQL > DISPATCH_LEVEL, o agendamento do temporizador será adiado até IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 8 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
IRQL	Qualquer

Consulte também

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification

Compartilhar via