Funzione NdisMRegisterWdiMiniportDriver (dot11wdi.h)

Articolo
02/06/2025

Importante

Questo argomento fa parte del modello di driver WDI rilasciato in Windows 10. Il modello di driver WDI è in modalità di manutenzione e riceverà solo correzioni con priorità elevata. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti.

Un driver miniport chiama la funzione NdisMRegisterWdiMiniportDriver per registrare i punti di ingresso MiniportWdiXxx con NDIS come primo passaggio dell'inizializzazione.

Sintassi

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

Parametri

[in] DriverObject

Puntatore a un oggetto driver opaco ricevuto dal driver miniport nella routine DriverEntry nel parametro Argument1 (vedere DriverEntry dei driver miniport NDIS).

[in] RegistryPath

Puntatore a un percorso opaco del Registro di sistema ricevuto dal driver miniport nella routine DriverEntry nel parametro Argument2.

[in, optional] NdisDriverContext

Handle per un'area di contesto allocata dal driver in cui il driver mantiene le informazioni sullo stato e sulla configurazione.

[in] MiniportDriverCharacteristics

Puntatore a un oggetto NDIS_MINIPORT_DRIVER_CHARACTERISTICS struttura inizializzata dal chiamante.

[in] MiniportWdiCharacteristics

Puntatore a una struttura NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS inizializzata dal chiamante.

[out] NdisMiniportDriverHandle

Puntatore a una variabile handle fornita dal chiamante. NDIS scrive un handle in questa variabile che identifica in modo univoco questo driver. Il driver deve salvare questo handle per l'uso nelle successive chiamate di funzione NdisXxx.

Valore restituito

NdisMRegisterWdiMiniportDriver può restituire uno dei valori restituiti seguenti.

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NdisMRegisterWdiMiniportDriver ha registrato correttamente il driver miniport WDI.
NDIS_STATUS_BAD_CHARACTERISTICS	Il parametro CharacteristicsLength non è corretto per la versione NDIS specificata nel membro MajorNdisVersion nella struttura in MiniportDriverCharacteristics .
NDIS_STATUS_BAD_VERSION	Il MajorNdisVersion o MinorNdisVersion specificato nella struttura delle caratteristiche non è valido.
NDIS_STATUS_RESOURCES	Una carenza di risorse, possibilmente di memoria, ha impedito a NDIS di registrare il chiamante.
NDIS_STATUS_FAILURE	Si tratta di uno stato di errore predefinito, restituito quando nessuno degli errori precedenti ha causato l'esito negativo della registrazione.
Altri codici NDIS_STATUS	Codice NDIS_STATUS appropriato in caso di errore.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	dot11wdi.h
libreria	Ndis.lib
IRQL	PASSIVE_LEVEL

Vedere anche

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

Condividi tramite