NdisMSetMiniportAttributes 函数（ndis.h）

项目
02/07/2025

微型端口驱动程序必须从 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 返回以下状态值之一：

返回代码	描述
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes 已成功注册微型端口适配器属性。
NDIS_STATUS_BAD_VERSION	指示 NDIS 不支持在标头成员 MiniportAttributes 中指定的修订版成员中指定的版本。

言论

微型端口驱动程序必须先从其 MiniportInitializeEx 函数调用 NdisMSetMiniportAttributes，然后驱动程序才能调用任何其他 NdisXxx 函数，具体取决于提供给 NdisMSetMiniportAttributes的信息。

这 NDIS_MINIPORT_ADAPTER_ATTRIBUTES 联合是各种属性结构的占位符。微型端口驱动程序使用不同的属性结构多次调用 NdisMSetMiniportAttributes。微型端口驱动程序必须提供已初始化 MiniportInitializeEx中的 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 结构。微型端口驱动程序必须提供这些注册属性，然后才能调用任何其他 NdisXxx 函数，该函数依赖于这些属性或声明硬件资源。

驱动程序向 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 结构中的 NDIS 提供 MiniportAdapterContext 成员。 MiniportAdapterContext 成员标识 NDIS 作为输入参数传递给驱动程序的 MiniportXxx 函数的调用方提供的上下文区域。此上下文区域包含特定于微型端口适配器的状态信息。

微型端口驱动程序必须在 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 结构后，在 NDIS_MINIPORT_ADAPTER_REGISTRATION_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）