Een NDK-Capable Miniport Driver initialiseren

Een minipoortstuurprogramma dat ondersteuning biedt voor Network Direct kernel (NDK) wordt op dezelfde manier geïnitialiseerd als andere minipoortstuurprogramma's. Er moeten echter ook extra NDKPI-toegangspunten worden geregistreerd.

• DriverEntry-functie
• MiniportSetOptions-functie
• Verwante onderwerpen

DriverEntry-functie

De driverEntry-functie van elk miniportstuurprogramma initialiseert een NDIS_MINIPORT_DRIVER_CHARACTERISTICS structuur en geeft deze door aan NdisMRegisterMiniportDriver , zoals wordt beschreven op de volgende pagina's:

• Een minipoortstuurprogramma initialiseren
• Functie DriverEntry van NDIS Miniport Drivers

Het minipoortstuurprogramma dat geschikt is voor NDK, moet het volgende doen bij het initialiseren van de NDIS_MINIPORT_DRIVER_CHARACTERISTICS structuur:

• In het lid OidRequestHandler moet het minipoortstuurprogramma een MiniportOidRequest-functie registreren die ondersteuning biedt voor:

  • Alle NDKPI-OID's.

  • Alle OID's die verplicht zijn voor NDIS miniportstuurprogramma's in het algemeen.

    Notitie Voor een lijst van deze verplichte OID's, zie Verplichte OID's voor minipoortstuurprogramma's.

• In het lid SetOptionsHandler moet het minipoortstuurprogramma een MiniportSetOptions-functie registreren zoals beschreven in Het configureren van optionele Miniport Driver Services en de volgende sectie met de functie MiniportSetOptions.

MiniportSetOptions functie

NDIS roept de functie MiniportSetOptions onmiddellijk nadat de DriverEntry-functie van het minipoortstuurprogramma is geretourneerd. De functie MiniportSetOptions wordt aangeroepen in de context van de aanroep van het minipoortstuurprogramma naar NdisMRegisterMiniportDriver.

In de miniportSetOptions-functie registreert het minipoortstuurprogramma dat geschikt is voor NDK de NDK-functie en registreert de volgende vereiste NDKPI-functieinvoerpunten, zoals beschreven in Optionele Miniport Driver Services configureren:

• OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER)

• CloseNDKAdapterHandler (CLOSE_NDK_ADAPTER_HANDLER)

Als u NDKPI-toegangspunten voor deze functies wilt registreren, moet de miniportstuurprogramma-functie MiniportSetOptions het volgende doen:

1. Initialiseer een NDIS_NDK_PROVIDER_CHARACTERISTICS structuur.

   Notitie Let vooral op de beschrijving van het koptekstlid . Het minipoortstuurprogramma moet dit lid correct instellen om zichzelf te identificeren als een minipoortstuurprogramma dat geschikt is voor NDK.

2. Sla de functieinvoerpunten op in de leden van de structuur OpenNDKAdapterHandler en CloseNDKAdapterHandler .

3. Roep de functie NdisSetOptionalHandlers aan en geef de structuur door in de parameter OptionalHandlers .

Verwante onderwerpen

Network Direct Kernel Provider Interface (NDKPI)