NetAdapterCreate, fonction (netadapter.h)

  • Article

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 précédemment reçue d’un appel à NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée par l’appelant. L’objet 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 retournée

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 Initialisation de l’appareil.

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

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1,27 %
En-tête netadapter.h (inclure netadaptercx.h)
Bibliothèque NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL