Funzione NetAdapterInitAllocate (netadapter.h)
La funzione NetAdapterInitAllocate alloca una struttura NETADAPTER_INIT usata da un driver client durante la creazione di un nuovo oggetto NETADAPTER.
Sintassi
NETADAPTER_INIT * NetAdapterInitAllocate(
[_In_] WDFDEVICE Device
);
Parametri
[_In_] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Restituisce un puntatore a una struttura NETADAPTER_INIT allocata dal framework se l'operazione ha esito positivo. In caso contrario, questa funzione restituisce NULL.
Importante
Se un driver client riceve una struttura NETADAPTER_INIT da una chiamata riuscita a questa funzione, il driver deve sempre chiamare NetAdapterInitFree per deallocarlo indipendentemente dal risultato di NetAdapterCreate.
Osservazioni
Un driver client chiama NetAdapterInitAllocate per ottenere una struttura NETADAPTER_INIT che può passare a NetAdapterCreate.
Dopo aver completato NetAdapterInitAllocate, i driver client possono chiamare facoltativamente funzioni NetAdapterInitSetXxxXxx per impostare altri attributi di inizializzazione per NETADAPTER.
Per un esempio di codice relativo alla creazione di un NETADAPTER, vedere 'inizializzazione del dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.27 |
| versione minima di UMDF | 2.33 |
| intestazione | netadapter.h (include netadaptercx.h) |
| libreria | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |