NdisMAllocatePort 函式 (ndis.h)

發行項
02/29/2024

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

語法

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

參數

NdisMiniportHandle

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

[in, out] PortCharacteristics

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

傳回值

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

傳回碼	Description
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_CHARACTERISTICSPortCharacteristics 參數指定的結構設定為指派給埠的埠號碼。

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

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包含 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL