MiniportCheckForHang
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função é um opcional função que reporta o estado do adaptador de rede ou monitora a capacidade de resposta de um subjacente driver de dispositivo.
Syntax
BOOLEAN MiniportCheckForHang(
NDIS_HANDLE MiniportAdapterContext
);
Parameters
- MiniportAdapterContext
[no] Especifica o identificador para uma área Miniport-allocated contexto no qual o driver mantém por-estado adaptador de rede, configurar por MiniportInitialize.
Return Value
MiniportCheckForHang Retorna TRUE se o driver determina que seu adaptador rede não está funcionando ou se um intermediário driver determina que o subjacente driver de dispositivo não está respondendo.
Remarks
Em Drivers adaptador de rede, MiniportCheckForHang não faz nada mais que verificar o estado interno do adaptador rede e TRUE do remetente se ele detecta que adaptador de rede não está funcionando corretamente.
Em intermediário drivers, MiniportCheckForHang Pode periodicamente verificar o estado da rede virtual adaptador do driver para determinar se o subjacente driver de dispositivo parece estar suspenso.
Por padrão, chama a biblioteca NDIS MiniportCheckForHang aproximadamente dois segundos.
Se MiniportCheckForHang Retorna TRUE, NDIS e chama do o driver MiniportReset função.
Se não tiver um driver adaptador rede MiniportCheckForHang função e NDIS judges o driver que não respondem como, de exemplo, quando NDIS contém muitos pendente envia e solicitações enfileirado para a miniporta para um intervalo tempo limite, NDIS chama do o driver MiniportReset função. Intervalo tempo limite usar como padrão da biblioteca de NDIS para enfileirado envia e solicitações é cerca de quatro segundos. No entanto, do driver adaptador uma rede MiniportInitialize função pode estender o intervalo tempo limite NDIS por chamado NdisMSetAttributesEx a partir MiniportInitialize Para evitar redefine desnecessários.
O MiniportInitialize função de um intermediário driver deve tempo limite intervalo do NDIS desativar com NdisMSetAttributesEx Porque tal um driver pode nenhum controle nem estimar um intervalo de conclusão razoável para o subjacente driver de dispositivo.
MiniportCheckForHang Pode ser Pre-empted por uma interrupção.
Requirements
| Header | externs.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |