Funzione NetAdapterCreate (netadapter.h)

Articolo
02/07/2025

Crea un oggetto NETADAPTER.

Sintassi

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

Parametri

[_In_] AdapterInit

Puntatore a una struttura di NETADAPTER_INIT ricevuta in precedenza dal driver client da una chiamata a NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES allocata dal chiamante. Il ParentObject della struttura deve essere NULL. Il parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Adapter

Puntatore a una posizione che riceve un handle per il nuovo oggetto NETADAPTER.

Valore restituito

La funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Osservazioni

Dopo aver chiamato WdfDeviceCreate, il client chiama in genere NetAdapterCreare dall'interno della routine EvtDriverDeviceAdd.

Per un esempio di codice relativo alla creazione di un NETADAPTER, vedere 'inizializzazione del dispositivo.

L'oggetto NETADAPTER è un oggetto WDF standard. Il framework gestisce l'eliminazione, che si verifica quando viene eliminato il WDFDEVICE padre.

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

Condividi tramite