NdisMAllocatePort-Funktion (ndis.h)

Artikel
02/26/2024

Die NdisMAllocatePort-Funktion weist einen NDIS-Port zu, der einem Miniportadapter zugeordnet ist.

Syntax

NDIS_STATUS NdisMAllocatePort(
            NDIS_HANDLE                NdisMiniportHandle,
  [in, out] PNDIS_PORT_CHARACTERISTICS PortCharacteristics
);

Parameter

NdisMiniportHandle

Das Miniportadapterhandle, das NDIS an den MiniportAdapterHandle-Parameter des MiniportInitializeEx-Funktion .

[in, out] PortCharacteristics

Ein Zeiger auf eine NDIS_PORT_CHARACTERISTICS Struktur, die die Merkmale des Ports definiert.

Rückgabewert

NdisMAllocatePort kann einen der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	NDIS hat Ressourcen für den Port erfolgreich zugeordnet.
NDIS_STATUS_RESOURCES	NDIS konnte keine Ressourcen für den Port zuordnen.
NDIS_STATUS_CLOSING	Fehler bei der Portzuordnung, weil der zugeordnete Miniportadapter geschlossen wird.
NDIS_STATUS_INVALID_DATA	Die Daten, die im PortCharacteristics-Parameter angegeben wurden, waren ungültig.

Hinweise

Die NdisMAllocatePort-Funktion ordnet Ressourcen und eine Portnummer für einen Port zu, der einem Miniportadapter zugeordnet ist. Der Port ist erst aktiv, wenn der Miniporttreiber ein NetEventPortActivation Plug & Play (PnP)-Ereignis für den Port ausgibt.

Nachdem der Miniporttreiber den Port aktiviert hat, generiert NDIS eine PnP-Benachrichtigung für die überlappenden Treiber. Wenn eine überlastende Treiber- oder Benutzermodusanwendung die OID_GEN_ENUMERATE_PORTS OID ausgibt, um die Ports eines Miniportadapters aufzulisten, schließt NDIS keine nicht aktiven zugeordneten Ports in die Liste der Ports ein.

Wenn NdisMAllocatePort erfolgreich zurückgegeben wird, ist das PortNumber-Element des NDIS_PORT_CHARACTERISTICS Struktur, die der PortCharacteristics-Parameter angibt, wird auf die Portnummer festgelegt, die NDIS dem Port zugewiesen hat.

Wenn ein Port nicht mehr benötigt wird, sollte der Miniporttreiber die NdisMFreePort-Funktion aufrufen, um den Port freizusetzen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL