Funzione NetAdapterCreate (netadapter.h)

Articolo
05/23/2024

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 NETADAPTER_INIT ricevuta in precedenza dal driver client da una chiamata a NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES allocata dal chiamante. L'oggetto 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.

Commenti

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

Per un esempio di codice per la 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.

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

Condividi tramite