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
Der Miniportadapterziehpunkt, den NDIS an den MiniportAdapterHandle Parameter des Parameters "MiniportAdapterHandle" übergeben hat MiniportInitializeEx Funktion.
[in, out] PortCharacteristics
Ein Zeiger auf einen 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, da der zugeordnete Miniportadapter geschlossen wird. |
|
Die daten, die an der PortCharacteristics Parameter bereitgestellt wurden, waren ungültig. |
Bemerkungen
Die NdisMAllocatePort--Funktion weist 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 and 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 ein übermäßiger Treiber oder eine Benutzermodusanwendung das OID_GEN_ENUMERATE_PORTS OID ausgibt, um die Ports eines Miniportadapters auflisten zu können, enthält NDIS keine nicht aktiven zugeordneten Ports in der Liste der Ports.
Wenn NdisMAllocatePort erfolgreich zurückgegeben wird, PortNumber Mitglied des NDIS_PORT_CHARACTERISTICS Struktur, die der PortCharacteristics Parameter angibt, wird auf die Portnummer festgelegt, die NDIS dem Port zugewiesen hat.
Nachdem kein Port mehr erforderlich ist, sollte der Miniporttreiber den NdisMFreePort--Funktion aufrufen, um den Port freizulegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |