NdisMAllocatePort 函式（ndis.h）

發行項
02/07/2025

NdisMAllocatePort 函式會配置與迷你埠配接器相關聯的 NDIS 埠。

語法

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

參數

NdisMiniportHandle

NDIS 傳遞至 MiniportAdapterHandle 參數的迷你埠配接器句柄 MiniportInitializeEx 函式。

[in, out] PortCharacteristics

的指標 NDIS_PORT_CHARACTERISTICS 結構，定義埠的特性。

傳回值

NdisMAllocatePort 可以傳回下列其中一個值：

傳回碼	描述
NDIS_STATUS_SUCCESS	NDIS 已成功為埠配置資源。
NDIS_STATUS_RESOURCES	NDIS 無法配置埠的資源。
NDIS_STATUS_CLOSING	埠配置失敗，因為相關聯的迷你埠配接器正在關閉。
NDIS_STATUS_INVALID_DATA	在 PortCharacteristics 參數提供的數據無效。

言論

NdisMAllocatePort 函式會配置資源，以及與迷你埠配接器相關聯的埠埠號碼。在迷你埠驅動程序發出 NetEventPortActivation 即插即用（PnP）事件之前，埠才會作用中。

在迷你埠驅動程序啟動埠之後，NDIS 會產生過度驅動程式的 PnP 通知。如果過度配置驅動程式或使用者模式應用程式發出 OID_GEN_ENUMERATE_PORTS OID 來列舉迷你埠適配卡的埠，NDIS 不會在埠清單中包含非使用中配置的埠。

NdisMAllocatePort 成功傳回時，PortNumber 成員 NDIS_PORT_CHARACTERISTICS ，PortCharacteristics 參數所指定的結構會設定為指派給埠的 NDIS 埠號碼。

不再需要埠之後，迷你埠驅動程序應該呼叫 NdisMFreePort 函式來釋放埠。

要求

要求	價值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平臺	普遍
標頭	ndis.h （包括 Ndis.h）
連結庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL