Função StorPortInitializeTimer (storport.h)

Cria um objeto de contexto de temporizador do Storport.

Sintaxe

ULONG StorPortInitializeTimer(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *TimerHandle
);

Parâmetros

[in] HwDeviceExtension

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

[out] TimerHandle

Um ponteiro para um buffer opaco que contém informações de contexto para o temporizador.

Retornar valor

A rotina StorPortInitializeTimer retorna um destes códigos status:

Código de retorno	Descrição
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL atual.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou TimerHandle é NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Recursos insuficientes estão disponíveis para inicializar o contexto do temporizador.
STOR_STATUS_SUCCESS	O contexto do temporizador foi inicializado com êxito.
STOR_STATUS_UNSUCCESSFUL	O número de temporizadores com suporte é excedido.

Comentários

O Storport fornece um único temporizador para um driver de miniporta usando o tipo de notificação RequestTimerCall em StorPortNotification. Se um miniporto exigir mais de um temporizador, temporizadores adicionais serão criados com StorPortInitializeTimer.

É recomendável que os miniportos chamem StorPortInitializeTimer na função HwStorFindAdapter para garantir que os recursos de temporizador adicionais estejam disponíveis.

Miniportos podem usar essa rotina para definir temporizadores de união para criar um período de atraso após um tempo limite inicial.

Antes de Windows 8, um máximo de 4 temporizadores podem ser criados com StorPortInitializeTimer. Começando com Windows 8, não há limitação máxima de temporizadores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível em Windows 8 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	storport.h (inclua Storport.h)
IRQL	<= DISPATCH_LEVEL

Confira também

HwStorFindAdapter

StorPortFreeTimer

StorPortNotification

StorPortRequestTimer