Fungsi NetAdapterOpenConfiguration (netadapter.h)

Fungsi NetAdapterOpenConfiguration membuka database konfigurasi adaptor bersih.

Sintaks

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parameter

[_In_] Adapter

Objek adaptor jaringan yang dibuat klien dalam panggilan sebelumnya ke NetAdapterCreate.

[_In_opt_] ConfigurationAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang berisi atribut yang disediakan driver untuk objek konfigurasi baru. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Configuration

Penunjuk ke lokasi yang menerima handel ke objek konfigurasi adaptor baru.

Menampilkan nilai

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

Keterangan

Biasanya, klien memanggil fungsi ini dari fungsi panggilan balik EVT_WDF_DRIVER_DEVICE_ADD .

Jika klien menyediakan WDF_OBJECT_ATTRIBUTES, klien menentukan NULL untuk ParentObject. Objek konfigurasi adaptor secara otomatis diinduk ke objek adaptor.

Akibatnya, WDF secara otomatis menghapus objek konfigurasi saat adaptor dihapus. Namun, klien dapat menghapus objek konfigurasi secara manual dengan memanggil WdfObjectDelete, biasanya dari fungsi panggilan balik EVT_WDF_OBJECT_CONTEXT_CLEANUP .

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1.21
Versi UMDF minimum	2.33
Header	netadapter.h (termasuk netadaptercx.h)
Pustaka	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Lihat juga

Mengakses informasi konfigurasi

NetConfigurationClose