Een minipoortadapter initialiseren
Wanneer een netwerkapparaat beschikbaar komt, laadt het systeem het vereiste NDIS-minipoortstuurprogramma als dit nog niet is geladen. Vervolgens verzendt de PnP-manager (Plug and Play) NDIS een Plug and Play IRP om het apparaat te starten. NDIS roept de MiniportInitializeEx--functie van het minipoortstuurprogramma aan om een adapter te initialiseren voor netwerk-I/O-bewerkingen. NDIS kan MiniportInitializeEx op elk gewenst moment aanroepen nadat het stuurprogramma is geïnitialiseerd. Zie Initialiseren van een Miniport-stuurprogrammavoor meer informatie over initialisatie van miniportstuurprogramma's.
Totdat MiniportInitializeEx retourneert, verzendt NDIS geen aanvragen voor de adapter die wordt geïnitialiseerd. De adapter bevindt zich in de status Initialiseren.
Een minipoortstuurprogramma voert doorgaans de volgende taken uit in MiniportInitializeEx:
Hiermee haalt u configuratiegegevens voor de adapter op.
Hiermee wordt informatie verkregen over de hardwarebronnen voor de adapter.
Roept de NdisMSetMiniportAttributes- aan en biedt de volgende kenmerken die zijn gekoppeld aan de adapter:
- Een aanwijzer naar een contextgebied dat aan een stuurprogramma is toegewezen.
- De juiste kenmerkenvlagken.
- Het time-outinterval voor het aanroepen van de MiniportCheckForHangEx---functie.
- Het interface-type.
Initialiseert adapterspecifieke resources.
Het minipoortstuurprogramma specificeert de adapterkenmerken in de NDIS_MINIPORT_ADAPTER_ATTRIBUTES structuur die MiniportInitializeEx doorgeeft aan NdisMSetMiniportAttributes.
Normaal gesproken wijst MiniportInitializeEx adapterspecifieke resources toe in de volgende volgorde:
Niet-gepagineerd poolgeheugen.
NET_BUFFER en NET_BUFFER_LIST pools (zie Miniport Driver Send and Receive Operations).
Spinlocks.
Tijdklokken.
IO-poorten.
DMA (zie Scatter/Gather DMA).
Gedeeld geheugen.
Interrupts (zie Onderbrekingen beheren).
Nadat MiniportInitializeEx succesvol is geretourneerd, bevindt de adapter zich in de status Gepauzeerd. NDIS kan de MiniportRestart functie aanroepen om de adapter over te schakelen naar de status Actief. Zie Een minipoortadapter startenvoor meer informatie.
Als MiniportInitializeEx NDIS_STATUS_SUCCESS retourneert, moet het stuurprogramma alle resources voor de adapter vrijgeven in de functie MiniportHaltEx-. Zie Een minipoortadapter stoppenvoor meer informatie.
Het stuurprogramma moet NdisMSetMiniportAttributes aanroepen en de GeneralAttributes instellen in de NDIS_MINIPORT_ADAPTER_ATTRIBUTES structuur als het NDIS_STATUS_SUCCESS retourneert.
Als MiniportInitializeEx mislukt, moet MiniportInitializeEx alle middelen vrijgeven die het heeft toegewezen voordat het terugkeert en de adapter teruggaat naar de status Gestopt.
Verwante onderwerpen
Miniport-adapterstatus en -bewerkingen