Fungsi NetAdapterCreate (netadapter.h)

Membuat objek NETADAPTER.

Sintaks

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

Parameter

[_In_] AdapterInit

Pointer ke struktur NETADAPTER_INIT yang sebelumnya diterima driver klien dari panggilan ke NetAdapterInitAllocate.

[_In_opt_] AdapterAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon. ParentObject struktur harus NULL. Parameter bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Adapter

Penunjuk ke lokasi yang menerima handel ke objek NETADAPTER baru.

Mengembalikan nilai

Fungsi mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Setelah disebut WdfDeviceCreate, klien biasanya memanggil NetAdapterCreate dari dalam rutinitas EvtDriverDeviceAdd - nya.

Untuk contoh kode pembuatan NETADAPTER, lihat Inisialisasi perangkat.

Objek NETADAPTER adalah objek WDF standar. Kerangka kerja mengelola penghapusannya, yang terjadi ketika WDFDEVICE induk dihapus.

Persyaratan

   
Target Platform Universal
Versi KMDF minimum 1.27
Header netadapter.h (termasuk netadaptercx.h)
Pustaka NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL