NdisMAllocatePort-Funktion (ndis.h)
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 hat Ressourcen für den Port erfolgreich zugeordnet. |
|
NDIS konnte keine Ressourcen für den Port zuordnen. |
|
Fehler bei der Portzuordnung, weil der zugeordnete Miniportadapter geschlossen wird. |
|
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 |