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.
Commenti
Un driver client chiama NetAdapterInitAllocate per ottenere una struttura NETADAPTER_INIT che può passare a NetAdapterCreate.
Dopo l'esito positivo di NetAdapterInitAllocate , i driver client possono chiamare facoltativamente le funzioni NetAdapterInitSetXxx per impostare ulteriori attributi di inizializzazione per NETADAPTER.
Per un esempio di codice per la creazione di un NETADAPTER, vedere Inizializzazione del dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.27 |
| Versione UMDF minima | 2.33 |
| Intestazione | netadapter.h (include netadaptercx.h) |
| Libreria | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |