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 pour un objet d’appareil d’infrastructure.
Valeur retournée
Retourne un pointeur vers une structure de NETADAPTER_INIT allouée par l’infrastructure 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 la libérer, quel que soit le résultat de NetAdapterCreate.
Remarques
Un pilote client appelle NetAdapterInitAllocate pour obtenir une structure NETADAPTER_INIT qu’il peut passer à NetAdapterCreate.
Une fois NetAdapterInitAllocate réussi, les pilotes clients peuvent éventuellement appeler les fonctions NetAdapterInitSetXxx pour définir d’autres attributs d’initialisation pour NETADAPTER.
Pour obtenir un exemple de code de création d’un NETADAPTER, consultez Initialisation de l’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1,27 % |
| Version UMDF minimale | 2,33 |
| En-tête | netadapter.h (inclure netadaptercx.h) |
| Bibliothèque | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |