Función NdisMSetMiniportAttributes (ndis.h)

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.

Tenga en cuenta que 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 de NdisXxx que dependa de estos atributos o que notificaciones de 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

   
Cliente mínimo compatible Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino Universal
Header ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)

Consulte también

Inicialización de un adaptador de minipuerto

MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_ATTRIBUTES NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_NDK_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_OFFLOAD_ATTRIBUTES

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES

Establecimiento de los atributos del adaptador de miniporte NDIS 6.0