Funzione NdisMSetMiniportAttributes (ndis.h)

Articolo
02/26/2024

Un driver miniport deve chiamare la funzione NdisMSetMiniportAttributes dalla funzione MiniportInitializeEx per identificare un'area di contesto per l'adattatore miniport a NDIS e fornire a NDIS informazioni sull'adattatore miniport.

Sintassi

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

Parametri

NdisMiniportHandle

Handle dell'adattatore miniport passato da NDIS al parametro MiniportAdapterHandle di MiniportInitializeEx.

[in] MiniportAttributes

Puntatore a un oggetto NDIS_MINIPORT_ADAPTER_ATTRIBUTES'unione che contiene una struttura di attributi allocata dal driver. La struttura definisce gli attributi dell'istanza dell'adattatore miniport specificata da MiniportAdapterHandle .

Valore restituito

NdisMSetMiniportAttributes restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes ha registrato correttamente gli attributi dell'adattatore miniport.
NDIS_STATUS_BAD_VERSION	Indica che NDIS non supporta la versione specificata nel membro Revision della struttura specificata nel membro Header in MiniportAttributes .

Commenti

Un driver miniport deve chiamare NdisMSetMiniportAttributes dalla funzione MiniportInitializeEx prima che il driver chiami qualsiasi altra funzione NdisXxx che dipende dalle informazioni fornite a NdisMSetMiniportAttributes.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES'unione è un segnaposto per varie strutture di attributi. Un driver miniport chiama NdisMSetMiniportAttributes più volte con strutture di attributi diverse. Un driver miniport deve fornire un inizializzato NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES struttura da MiniportInitializeEx. Il driver miniport deve fornire questi attributi di registrazione prima di chiamare qualsiasi altra funzione NdisXxx che dipende da questi attributi o che richiede risorse hardware.

Il driver fornisce un membro MiniportAdapterContext a NDIS nella struttura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES . Il membro MiniportAdapterContext identifica un'area di contesto fornita dal chiamante che NDIS passa come parametro di input alle funzioni MiniportXxx del driver. Questa area di contesto contiene informazioni sullo stato specifiche dell'adattatore miniport.

I driver miniport devono impostare gli attributi nel NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES struttura dopo aver impostato gli attributi di registrazione nella struttura NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES e prima di impostare eventuali attributi aggiuntivi.

Un driver miniport può anche chiamare NdisMSetMiniportAttributes dalla funzione MiniportAddDevice . In questo caso, la struttura NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES viene utilizzata per specificare l'area di contesto.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)