Función NdisMSetMiniportAttributes (ndis.h)

Artículo
02/29/2024

Un controlador de minipuerto 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 NDIS con información sobre el adaptador de miniporte.

Sintaxis

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

Parámetros

NdisMiniportHandle

Controlador 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 especifica MiniportAdapterHandle .

Valor devuelto

NdisMSetMiniportAttributes devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes registró 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 la estructura especificada en el miembro Header en MiniportAttributes .

Comentarios

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

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES unión es un marcador de posición para varias estructuras de atributos. Un controlador de minipuerto llama a NdisMSetMiniportAttributes varias veces con estructuras de atributos diferentes. Un controlador de minipuerto debe proporcionar un inicializado. NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estructura de MiniportInitializeEx. El controlador de minipuerto debe proporcionar estos atributos de registro antes de llamar a cualquier otra función NdisXxx 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 pasa NDIS como parámetro de entrada a las funciones MiniportXxx del controlador. Este área de contexto contiene información de estado específica del adaptador de miniporte.

Los controladores de minipuerto 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 minipuerto 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	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)