NdisMSetMiniportAttributes 函式（ndis.h）

發行項
02/07/2025

迷你埠驅動程序必須從 MiniportInitializeEx 函式呼叫 NdisMSetMiniportAttributes 函式，以識別迷你埠適配卡到 NDIS 的內容區域，並提供 NDIS 迷你埠配接器的相關信息。

語法

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

參數

NdisMiniportHandle

NDIS 傳遞至 MiniportAdapterHandleMiniportInitializeEx的迷你埠配接器句柄。

[in] MiniportAttributes

的指標 NDIS_MINIPORT_ADAPTER_ATTRIBUTES 聯集，其中包含驅動程式配置的屬性結構。結構會定義 miniport 配接器實例的屬性，MiniportAdapterHandle 指定。

傳回值

NdisMSetMiniportAttributes 會傳回下列其中一個狀態值：

傳回碼	描述
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes 已成功註冊迷你埠配接器屬性。
NDIS_STATUS_BAD_VERSION	表示 NDIS 不支援在 Header 成員中指定的 Revision 成員中指定的版本，MiniportAttributes 。

言論

迷你埠驅動程序必須先從其 MiniportInitializeEx 函式呼叫 NdisMSetMiniportAttributes，然後驅動程式才能呼叫任何其他 NdisXxx 函式，視提供給 NdisMSetMiniportAttributes的資訊而定。

這 NDIS_MINIPORT_ADAPTER_ATTRIBUTES 等位是各種屬性結構的佔位元。迷你埠驅動程式會呼叫 NdisMSetMiniportAttributes 多次使用不同的屬性結構。迷你埠驅動程序必須提供已初始化從 MiniportInitializeEx NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 結構。迷你埠驅動程序必須先提供這些註冊屬性，才能呼叫任何其他 NdisXxx 函式，該函式相依於這些屬性或宣告硬體資源。

驅動程式會將 MiniportAdapterContext 成員提供給 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 結構中的 NDIS。 MiniportAdapterContext 成員會識別 NDIS 傳遞作為輸入參數給驅動程式 MiniportXxx 函式的呼叫端提供的內容區域。此內容區域包含迷你埠-配接器特定狀態資訊。

迷你埠驅動程序必須在中設定屬性在 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 結構中設定註冊屬性之後，以及在設定任何其他屬性之前， NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 結構。

迷你埠驅動程式也可以從其 MiniportAddDevice 函式呼叫 NdisMSetMiniportAttributes。在此情況下，會使用 NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES 結構來指定內容區域。

要求

要求	價值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
目標平臺	普遍
標頭	ndis.h （包括 Ndis.h）
連結庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Miniport_Driver_Function（ndis）， NdisMRegisterIoPortRange（ndis）