Condividi tramite


Funzione NdisMSetMiniportAttributes (ndis.h)

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)

Vedi anche

Inizializzazione di un adattatore Miniport

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

Impostazione degli attributi dell'adattatore Miniport NDIS 6.0