Macro NdisMInitializeWrapper (ndis.h)

Article
02/27/2024

Note 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. x pilotes dans NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

NdisMInitializeWrapper informe NDIS qu’un nouveau pilote miniport est en cours d’initialisation.

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 se représente. Si l’appel à NdisMInitializeWrapper échoue, NDIS définit la variable sur NdisWrapperHandle sur NULL.

[in] _b

Spécifie un pointeur d’un type propre 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 propre au système.

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

[in] _d

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

Pour les pilotes Windows 2000 et versions ultérieures, ce pointeur doit avoir la valeur NULL lorsque le pilote miniport appelle NdisMInitializeWrapper.

Valeur de retour

None

Remarques

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

Les appels ultérieurs d’un tel pilote aux fonctions d’initialisation et de configuration NdisXxx doivent passer le NdisWrapperHandle en tant que paramètre. Par conséquent, il s’agit d’un paramètre d’entrée de la fonction MiniportInitialize .

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