Fonction NdisMRegisterWdiMiniportDriver (dot11wdi.h)

  • Article

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 avec 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 que le pilote miniport a reçu dans sa routine DriverEntry au niveau du paramètre Argument1 (voir DriverEntry des pilotes miniport NDIS).

[in] RegistryPath

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

[in, optional] NdisDriverContext

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

[in] MiniportDriverCharacteristics

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

[in] MiniportWdiCharacteristics

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

[out] NdisMiniportDriverHandle

Pointeur vers une variable de handle fournie par l’appelant. NDIS écrit un handle dans cette variable qui identifie de manière unique ce pilote. Le pilote doit enregistrer ce handle pour l’utiliser dans les appels de fonction NdisXxx suivants.

Valeur retournée

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

Code de retour Description
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver a enregistré le pilote miniport WDI avec succès.
NDIS_STATUS_BAD_CHARACTERISTICS
 Le paramètre CharacteristicsLength n’est pas correct pour la version NDIS spécifiée au niveau du membre MajorNdisVersion dans la structure de 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, a empêché NDIS d’inscrire l’appelant.
NDIS_STATUS_FAILURE
 Il s’agit d’une erreur par défaut status, retournée quand aucune des erreurs précédentes n’a provoqué l’échec de l’inscription.
Autres codes NDIS_STATUS
 Un NDIS_STATUS code approprié en cas de défaillance.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
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