MINIPORT_PAUSE função de retorno de chamada (ndis.h)
O NDIS chama a função MiniportPause de um driver de miniporto para interromper o fluxo de dados de rede por meio de um adaptador de miniporto especificado.
Sintaxe
MINIPORT_PAUSE MiniportPause;
NDIS_STATUS MiniportPause(
[in] NDIS_HANDLE MiniportAdapterContext,
[in] PNDIS_MINIPORT_PAUSE_PARAMETERS PauseParameters
)
{...}
Parâmetros
[in] MiniportAdapterContext
Um identificador para uma área de contexto que o driver de miniporto alocou em sua função MiniportInitializeEx. O driver de miniporto usa essa área de contexto para manter informações de estado para um adaptador de miniporto.
[in] PauseParameters
Um ponteiro para um NDIS_MINIPORT_PAUSE_PARAMETERS estrutura que define os parâmetros de pausa para o adaptador de miniporto.
Valor de retorno
MiniportPause retorna um dos seguintes valores de status:
Observações
Um driver especifica o ponto de entrada MiniportPause quando ele chama o função NdisMRegisterMiniportDriver.
O NDIS pausa um adaptador de miniporto para interromper o fluxo de dados que pode interferir em operações PnP, como adicionar ou remover um driver de filtro ou associar ou desvincular um driver de protocolo.
O NDIS chama a função MiniportPause do driver de miniport para iniciar uma solicitação de pausa para o adaptador de miniporto especificado em MiniportAdapterContext. O adaptador de miniporto permanece no estado Pausando até que a operação de pausa seja concluída.
Para um adaptador de miniporto no estado Pausando, o driver de miniporto:
- Aguarda todas as chamadas para o função NdisMIndicateReceiveNetBufferLists a ser retornada.
- Aguarda que o NDIS retorne a propriedade de todas as estruturas de NET_BUFFER_LIST de indicações de recebimento pendentes para o driver de miniporto função MiniportReturnNetBufferLists.
- Conclui todas as solicitações de envio pendentes e chama o função de NdisMSendNetBufferListsComplete para todas as solicitações de envio pendentes.
- Rejeita todas as novas solicitações de envio feitas à sua função MiniportSendNetBufferLists imediatamente chamando NdisMSendNetBufferListsComplete. Ele deve definir o status completo em cada NET_BUFFER_LIST para NDIS_STATUS_PAUSED.
- Pode fornecer indicações de status com o função NdisMIndicateStatusEx.
- Deve lidar com solicitações OID na função MiniportOidRequest.
- Não deve interromper completamente o adaptador de miniporto se parar o adaptador de miniporto impedir que o driver manifique solicitações ou forneça indicações de status.
- Não deve liberar os recursos que o driver alocou durante a inicialização.
Depois que um driver de miniporto concluir todas as solicitações de envio pendentes e o NDIS retornar todas as estruturas de dados de rede recebidas (de indicações de recebimento pendentes), o driver deverá concluir a operação de pausa. Se o driver retornar NDIS_STATUS_SUCCESS de MiniportPause, a operação de pausa será concluída. Se o driver retornar NDIS_STATUS_PENDING, o adaptador de miniporto poderá permanecer no estado Pausar e a operação de pausa for concluída depois que o driver chamar a função NdisMPauseComplete. Depois que a operação de pausa for concluída, o adaptador de miniporto estará no estado de pausado.
Para um adaptador de miniporto no estado pausado, o driver de miniporto:
- Deve rejeitar todas as solicitações de envio feitas para miniportSendNetBufferLists imediatamente chamando NdisMSendNetBufferListsComplete. Ele deve definir o membro Status em cada NET_BUFFER_LIST para NDIS_STATUS_PAUSED.
- Pode lidar com interrupções de recebimento (consulte a função MiniportInterrupt) e interromper DPCs (consulte a função MiniportInterruptDPC), mas não deve indicar dados de rede recebidos.
- Pode fornecer indicações de status com a função NdisMIndicateStatusEx.
- Deve lidar com solicitações OID na função MiniportOidRequest.
- Deve lidar com solicitações para alterar o estado de energia do dispositivo no função de MiniportDevicePnPEventNotify.
- Pode lidar com chamadas para funções de NetTimerCallback.
- Pode lidar com solicitações para redefinir o hardware na função MiniportResetEx.
O NDIS chama a função MiniportRestart para iniciar uma solicitação de reinicialização para um adaptador de miniporto pausado.
Chamadas NDIS MiniportPause no IRQL = PASSIVE_LEVEL.
exemplos de
Para definir uma função MiniportPause, primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda Análise de Código para Drivers, SDV (Verificador de Driver Estático) e outras ferramentas de verificação a encontrar erros e é um requisito para gravar drivers para o sistema operacional Windows.Por exemplo, para definir uma função MiniportPause chamada "MyPause", use o tipo MINIPORT_PAUSE, conforme mostrado neste exemplo de código:
MINIPORT_PAUSE MyPause;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
NDIS_STATUS
MyPause(
NDIS_HANDLE MiniportAdapterContext,
PNDIS_MINIPORT_PAUSE_PARAMETERS MiniportPauseParameters
)
{...}
O tipo de função MINIPORT_PAUSE é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função MINIPORT_PAUSE no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.
Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| da Plataforma de Destino | Windows |
| cabeçalho | ndis.h (inclua Ndis.h) |
| IRQL | PASSIVE_LEVEL |