Função StorPortInitializeTimer (storport.h)
Cria um objeto de contexto do temporizador 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.
Valor de retorno
A rotina StorPortInitializeTimer do retorna um destes códigos de status:
| Código de retorno | Descrição |
|---|---|
|
> DISPATCH_LEVEL IRQL atual. |
|
HwDeviceExtension ou TimerHandle é NULL. |
|
Recursos insuficientes estão disponíveis para inicializar o contexto do temporizador. |
|
O contexto do temporizador foi inicializado com êxito. |
|
O número de temporizadores com suporte é excedido. |
Observações
O Storport fornece um único temporizador para um driver de miniporto 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 adicionais do temporizador estejam disponíveis.
Os miniportos podem usar essa rotina para definir temporizadores de associação para criar um período de atraso após um tempo limite inicial.
Antes do Windows 8, um máximo de 4 temporizadores pode ser criado com StorPortInitializeTimer. A partir do Windows 8, não há limitação máxima de temporizadores.
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 | <= DISPATCH_LEVEL |