Función NdisMSetMiniportAttributes (ndis.h)

Artículo
02/07/2025

Un controlador de miniport debe llamar a la función NdisMSetMiniportAttributes desde su función MiniportInitializeEx para identificar un área de contexto para el adaptador de miniporte a NDIS y proporcionar a NDIS información sobre el adaptador de miniport.

Sintaxis

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

Parámetros

NdisMiniportHandle

Identificador del adaptador de miniporte que NDIS pasó al parámetro MiniportAdapterHandle de MiniportInitializeEx.

[in] MiniportAttributes

Puntero a un NDIS_MINIPORT_ADAPTER_ATTRIBUTES unión que contiene una estructura de atributos asignados por controladores. La estructura define los atributos de la instancia del adaptador de miniport que miniportAdapterHandle especifica.

Valor devuelto

NdisMSetMiniportAttributes devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes registrar correctamente los atributos del adaptador de miniport.
NDIS_STATUS_BAD_VERSION	Indica que NDIS no admite la versión especificada en el miembro revision de de la estructura especificada en el miembro Header en MiniportAttributes .

Observaciones

Un controlador de miniport debe llamar a NdisMSetMiniportAttributes desde su función MiniportInitializeEx antes de que el controlador llame a cualquier otra función NdisXxx que depende de la información proporcionada a NdisMSetMiniportAttributes.

El NDIS_MINIPORT_ADAPTER_ATTRIBUTES unión es un marcador de posición para varias estructuras de atributos. Un controlador de miniporta llama a NdisMSetMiniportAttributes varias veces con estructuras de atributos diferentes. Un controlador de miniport debe proporcionar una inicialización NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estructura de MiniportInitializeEx. El controlador de miniport debe proporcionar estos atributos de registro antes de llamar a cualquier otro Ndisfunción Xxx que dependa de estos atributos o que reclama recursos de hardware.

El controlador proporciona un miembro MiniportAdapterContext a NDIS en la estructura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES. El miembro MiniportAdapterContext identifica un área de contexto proporcionada por el autor de la llamada que NDIS pasa como parámetro de entrada a las funciones de MiniportXxx del controlador. Este área de contexto contiene información de estado específica del miniport-adapter.

Los controladores de miniport deben establecer los atributos en . NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES estructura después de establecer los atributos de registro en la estructura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES y antes de establecer atributos adicionales.

Un controlador de miniport también puede llamar a NdisMSetMiniportAttributes desde su función MiniportAddDevice. En este caso, la estructura NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES se usa para especificar el área de contexto.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)