NdisMSetMiniportAttributes 函式 (ndis.h)

發行項
02/26/2024

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

語法

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

參數

NdisMiniportHandle

迷你埠配接器會處理 NDIS 傳遞至 MiniportInitializeEx 的 MiniportAdapterHandle 參數。

[in] MiniportAttributes

的指標 NDIS_MINIPORT_ADAPTER_ATTRIBUTES 等位，其中包含驅動程式配置的屬性結構。結構會定義 MiniportAdapterHandle 所指定迷你埠 配接器實例的屬性。

傳回值

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

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

備註

迷你埠驅動程序必須從其 MiniportInitializeEx 函式呼叫 NdisMSetMiniportAttributes，驅動程式才能呼叫任何其他 NdisXxx 函式，此函式取決於提供給 NdisMSetMiniportAttributes 的資訊。

The 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 和更新版本支援。
目標平台	Universal
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 合規性規則	Irql_Miniport_Driver_Function (ndis) 、 NdisMRegisterIoPortRange (ndis)