Inicializando um NDK-Capable Miniport Driver
Um driver de miniporta que dá suporte ao kernel direto de rede (NDK) é inicializado da mesma forma que outros drivers de miniporta. No entanto, ele também deve registrar pontos de entrada NDKPI adicionais.
Função DriverEntry
Cada função DriverEntry do driver de miniporta inicializa uma estrutura NDIS_MINIPORT_DRIVER_CHARACTERISTICS e a passa para NdisMRegisterMiniportDriver , conforme descrito nas seguintes páginas:
O driver de miniporto compatível com NDK deve fazer o seguinte ao inicializar a estrutura de NDIS_MINIPORT_DRIVER_CHARACTERISTICS :
No membro OidRequestHandler , o driver de miniport deve registrar uma função MiniportOidRequest que dê suporte a:
Todos os OIDs de NDKPI.
Todos os OIDs obrigatórios para drivers de miniporta NDIS em geral.
Nota Para obter uma lista desses OIDs obrigatórios, consulte OIDs obrigatórios para drivers de miniport.
No membro SetOptionsHandler , o driver de miniporto deve registrar uma função MiniportSetOptions , conforme descrito em Configurando serviços de driver de miniporto opcionais e a seguinte seção de função MiniportSetOptions.
Função MiniportSetOptions
O NDIS chama a função MiniportSetOptions imediatamente após o retorno da função DriverEntry do driver de miniport. A função MiniportSetOptions é chamada no contexto da chamada do driver de miniport para NdisMRegisterMiniportDriver.
Em sua função MiniportSetOptions , o driver de miniporto compatível com NDK registra sua funcionalidade NDK e registra os seguintes pontos de entrada de função NDKPI necessários, conforme descrito em Configurando serviços de driver de miniporto opcionais:
OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER)
CloseNDKAdapterHandler (CLOSE_NDK_ADAPTER_HANDLER)
Para registrar pontos de entrada NDKPI para essas funções, a função MiniportSetOptions do driver de miniport deve fazer o seguinte:
Inicialize uma estrutura NDIS_NDK_PROVIDER_CHARACTERISTICS .
Nota Preste atenção especial à descrição do membro cabeçalho . O driver de miniporta deve definir esse membro corretamente para se identificar como um driver de miniporta compatível com NDK.
Armazene os pontos de entrada de função nos membros OpenNDKAdapterHandler e CloseNDKAdapterHandler da estrutura.
Chame a função NdisSetOptionalHandlers , passando a estrutura no parâmetro OptionalHandlers .