NetAdapterInitAllocate, fonction (netadapter.h)
La fonction NetAdapterInitAllocate alloue une structure NETADAPTER_INIT qu’un pilote client utilise lors de la création d’un objet NETADAPTER.
Syntaxe
NETADAPTER_INIT * NetAdapterInitAllocate(
[_In_] WDFDEVICE Device
);
Paramètres
[_In_] Device
Handle vers un objet d’appareil framework.
Valeur de retour
Retourne un pointeur vers une structure NETADAPTER_INIT allouée au framework si l’opération réussit. Sinon, cette fonction retourne NULL.
Important
Si un pilote client reçoit une structure NETADAPTER_INIT d’un appel réussi à cette fonction, le pilote doit toujours appeler NetAdapterInitFree pour le libérer quel que soit le résultat de NetAdapterCreate.
Remarques
Un pilote client appelle NetAdapterInitAllocate pour obtenir une structure NETADAPTER_INIT qu’elle peut passer à NetAdapterCreate.
Une fois NetAdapterInitAllocate réussit, les pilotes clients peuvent éventuellement appeler fonctions NetAdapterInitSetXxx pour définir des attributs d’initialisation supplémentaires pour NETADAPTER.
Pour obtenir un exemple de code de création d’un NETADAPTER, consultez d’initialisation de l’appareil.
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 |