NdisMFreePort 函式 (ndis.h)

發行項
02/29/2024

NdisMFreePort 函式會釋放先前使用 NdisMAllocatePort 函式配置的 NDIS 埠。

語法

NDIS_STATUS NdisMFreePort(
       NDIS_HANDLE      NdisMiniportHandle,
  [in] NDIS_PORT_NUMBER PortNumber
);

參數

NdisMiniportHandle

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

[in] PortNumber

NDIS 應釋放的NDIS埠數目。 PortNumber 值是具有 ULONG 數據類型的 NDIS_PORT_NUMBER 值。 NDIS 在的 PortNumber 成員中提供埠號碼當迷你埠驅動程式呼叫 NdisMAllocatePort 函式時，NDIS_PORT_CHARACTERISTICS結構。

埠號碼可以是從 1 到0xffffff的數位。您無法將 PortNumber 設定為零，這表示預設埠。

傳回值

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

傳回碼	Description
NDIS_STATUS_SUCCESS	NDIS 已成功釋放埠的資源。
NDIS_STATUS_INVALID_PORT	NDIS 無法釋放埠的資源，因為埠號碼無效。
NDIS_STATUS_INVALID_PORT_STATE	NDIS 無法釋放埠的資源，因為埠處於可用作業無效的狀態。若要釋放埠，埠必須處於已配置狀態。
NDIS_STATUS_INVALID_DATA	PortNumber 參數提供的埠號碼無效。

備註

如果迷你埠驅動程式藉由呼叫 NdisMAllocatePort 函式來配置埠，則驅動程式必須先釋放埠，才能從其 MiniportHaltEx 函式傳回。如果迷你埠驅動程式透過發出 NetEventPortActivation 隨插即用 (PnP) 事件來啟動埠，則驅動程式必須先發出埠的 NetEventPortDeactivation PnP 事件，才能釋放埠。

當迷你埠驅動程式呼叫 NdisMFreePort 以釋放埠時，NDIS 也會釋放指派給釋放埠的埠號碼，讓 NDIS 可以重複使用埠號碼。

迷你埠驅動程式不得嘗試釋放預設埠。

規格需求

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