NdisMSetMiniportAttributes 函数 (ndis.h)

项目
08/07/2023

微型端口驱动程序必须从其 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 的标头成员中指定的结构的 Revision 成员中指定的版本。

注解

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

The 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_REGISTRATION_ATTRIBUTES 结构中设置注册属性之后以及设置任何其他属性之前， NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 结构。

微型端口驱动程序还可以从其 MiniportAddDevice 函数调用 NdisMSetMiniportAttributes。在这种情况下， NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES 结构用于指定上下文区域。

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
目标平台	通用
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI 符合性规则	Irql_Miniport_Driver_Function (ndis) ， NdisMRegisterIoPortRange (ndis)