NetAdapterCreate, fonction (netadapter.h)

Article
02/07/2025

Crée un objet NETADAPTER.

Syntaxe

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

Paramètres

[_In_] AdapterInit

Pointeur vers une structure NETADAPTER_INIT que le pilote client a reçu précédemment d’un appel à NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant. Le ParentObject de la structure doit être NULL. Le paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Adapter

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet NETADAPTER.

Valeur de retour

La fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Une fois qu’il a appelé WdfDeviceCreate, le client appelle généralement NetAdapterCreate à partir de sa routine EvtDriverDeviceAdd.

Pour obtenir un exemple de code de création d’un NETADAPTER, consultez d’initialisation de l’appareil.

L’objet NETADAPTER est un objet WDF standard. L’infrastructure gère sa suppression, qui se produit lorsque le WDFDEVICE parent est supprimé.

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.27
version minimale de UMDF	2.33
d’en-tête	netadapter.h (include netadaptercx.h)
bibliothèque	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Partager via