Funzione NetAdapterCreate (netadapter.h)

  • Articolo

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
Intestazione netadapter.h (include netadaptercx.h)
Libreria NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL