MINIPORT_ENABLE_INTERRUPT função de retorno de chamada (ndis.h)
O NDIS pode chamar o manipulador MiniportEnableInterruptEx de um driver de miniport para habilitar interrupções para fins de diagnóstico e solução de problemas.
Sintaxe
MINIPORT_ENABLE_INTERRUPT MiniportEnableInterrupt;
void MiniportEnableInterrupt(
[in] NDIS_HANDLE MiniportInterruptContext
)
{...}
Parâmetros
[in] MiniportInterruptContext
Um identificador para um bloco de informações de contexto. O driver de miniporta forneceu esse identificador no parâmetro MiniportInterruptContext que o driver de miniporto passou para o Função NdisMRegisterInterruptEx .
Retornar valor
Nenhum
Comentários
Um driver de miniporto deve fornecer um manipulador MiniportEnableInterruptEx se o driver chamar a função NdisMRegisterInterruptEx para registrar uma interrupção.
Os drivers de miniport devem desabilitar e habilitar interrupções, conforme explicado nas páginas de referência MiniportInterrupt e MiniportInterruptDpc .
O NDIS chama o MiniportEnableInterruptEx eFunções MiniportDisableInterruptEx para habilitar e desabilitar interrupções para fins de diagnóstico e solução de problemas. Normalmente, MiniportEnableInterruptEx e MiniportDisableInterruptEx acessam recursos de driver de miniport que são compartilhados pela função MiniportInterrupt . Portanto, o NDIS chama esses manipuladores em DIRQL.
Exemplos
Para definir uma função MiniportEnableInterruptEx , 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 a 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 escrever drivers para o sistema operacional Windows.Por exemplo, para definir uma função MiniportEnableInterruptEx chamada "MyEnableInterruptEx", use o tipo MINIPORT_ENABLE_INTERRUPT conforme mostrado neste exemplo de código:
MINIPORT_ENABLE_INTERRUPT MyEnableInterruptEx;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
VOID
MyEnableInterruptEx(
NDIS_HANDLE MiniportInterruptContext
)
{...}
O tipo de função MINIPORT_ENABLE_INTERRUPT é 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_ENABLE_INTERRUPT 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 |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Windows |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| IRQL | Consulte a seção Comentários |