Macro NdisMInitializeWrapper (ndis.h)

Article
02/07/2025

Remarque NDIS 5. x a été déconseillé et est remplacé par NDIS 6. x. Pour le développement de nouveaux pilotes NDIS, consultez Pilotes réseau à partir de Windows Vista. Pour plus d’informations sur le portage de NDIS 5. pilotes x vers NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

NdisMInitializeWrapper informe NDIS qu’un nouveau pilote miniport est initialisé.

Syntaxe

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Paramètres

[out] _a

Pointeur vers une variable fournie par l’appelant dans laquelle NDIS retourne un handle qui représente lui-même. Si l’appel à NdisMInitializeWrapper échoue, NDIS définit la variable sur NdisWrapperHandle sur NULL.

[in] _b

Spécifie un pointeur d’un type spécifique au système.

Pour les pilotes Windows 2000 et versions ultérieures, il s’agit d’un pointeur vers une entrée d’objet pilote opaque vers la fonction DriverEntry du pilote miniport.

[in] _c

Spécifie un pointeur d’un type spécifique au système.

Pour les pilotes Windows 2000 et versions ultérieures, il s’agit d’un pointeur vers une entrée de chemin d’accès de Registre opaque vers la fonction DriverEntry du pilote miniport.

[in] _d

Spécifie un pointeur d’un type spécifique au système.

Pour les pilotes Windows 2000 et versions ultérieures, ce pointeur doit être défini sur NULL lorsque le pilote miniport appelle NdisMInitializeWrapper.

Valeur de retour

Aucun

Remarques

Un pilote de carte réseau ou un pilote intermédiaire doit appeler NdisMInitializeWrapper avant d’appeler n’importe quelle autre fonction NdisXxx. En règle générale, cet appel est l’action initiale d’une fonction DriverEntry du pilote NIC, qui appelle NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport avec le NdisWrapperHandle retourné suivant. Les pilotes intermédiaires NDIS doivent également appeler NdisMInitializeWrapper à partir de la fonction DriverEntry, puis appeler NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport avec le NdisWrapperHandle.

Les appels suivants d’un pilote à NdisXxx les fonctions d’initialisation et de configuration doivent passer les NdisWrapperHandle en tant que paramètre. Par conséquent, il s’agit d’un paramètre d’entrée dans la fonction MiniportInitialize.

Si l’appel à NdisMInitializeWrapper échoue, NDIS définit la variable à NdisWrapperHandle sur NULL. Le pilote doit toujours vérifier la valeur de cette variable après NdisMInitializeWrapper retourne. Si la valeur est NULL, le pilote doit échouer à l’appel à la fonction DriverEntry.