NdisMRegisterWdiMiniportDriver, fonction (dot11wdi.h)

Article
02/06/2025

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

Un pilote miniport appelle la fonction NdisMRegisterWdiMiniportDriver pour inscrire les points d’entrée MiniportWdiXxx auprès de NDIS comme première étape de l’initialisation.

Syntaxe

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
);

Paramètres

[in] DriverObject

Pointeur vers un objet pilote opaque reçu par le pilote miniport dans sa routine DriverEntry au paramètre Argument1 (voir DriverEntry de NDIS Miniport Drivers).

[in] RegistryPath

Pointeur vers un chemin de Registre opaque reçu par le pilote miniport dans sa routine DriverEntry au paramètre Argument2.

[in, optional] NdisDriverContext

Handle vers une zone de contexte allouée par le pilote où le pilote gère les informations d’état et de configuration.

[in] MiniportDriverCharacteristics

Pointeur vers un NDIS_MINIPORT_DRIVER_CHARACTERISTICS structure initialisée par l’appelant.

[in] MiniportWdiCharacteristics

Pointeur vers une structure NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS initialisée par l’appelant.

[out] NdisMiniportDriverHandle

Pointeur vers une variable de handle fournie par l’appelant. NDIS écrit un handle dans cette variable qui identifie de façon unique ce pilote. Le pilote doit enregistrer ce handle à utiliser dans les appels de fonction Ndis suivantsXxx.

Valeur de retour

NdisMRegisterWdiMiniportDriver peut retourner l’une des valeurs de retour suivantes.

Retourner le code	Description
NDIS_STATUS_SUCCESS	NdisMRegisterWdiMiniportDriver inscrit le pilote WDI miniport avec succès.
NDIS_STATUS_BAD_CHARACTERISTICS	Le paramètre CharacteristicsLength est incorrect pour la version NDIS spécifiée au membre MajorNdisVersion dans la structure à MiniportDriverCharacteristics.
NDIS_STATUS_BAD_VERSION	La MajorNdisVersion ou MinorNdisVersion spécifiée dans la structure des caractéristiques n’est pas valide.
NDIS_STATUS_RESOURCES	Une pénurie de ressources, éventuellement de mémoire, empêchait NDIS d’inscrire l’appelant.
NDIS_STATUS_FAILURE	Il s’agit d’un état d’erreur par défaut, retourné lorsqu’aucune des erreurs précédentes n’a provoqué l’échec de l’inscription.
autres codes de NDIS_STATUS	Code NDIS_STATUS approprié en cas d’échec.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
d’en-tête	dot11wdi.h
bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL

Voir aussi

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

Partager via