Funzione NetAdapterInitAllocate (netadapter.h)

La funzione NetAdapterInitAllocate alloca una struttura NETADAPTER_INIT utilizzata 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 deallocare il 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 funzioni NetAdapterInitSetXxx per impostare ulteriori attributi di inizializzazione per NETADAPTER.

Per un esempio di codice di creazione di un NETADAPTER, vedere Inizializzazione del dispositivo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.27
Intestazione	netadapter.h (include netadaptercx.h)
Libreria	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

Inizializzazione del dispositivo

NetAdapterCreate

NetAdapterInitFree