Fungsi NetDeviceOpenConfiguration (netdevice.h)

Fungsi NetDeviceOpenConfiguration membuka database konfigurasi perangkat bersih.

Sintaks

NTSTATUS NetDeviceOpenConfiguration(
  [_In_]     WDFDEVICE             Device,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parameter

[_In_] Device

Objek WDFDEVICE driver klien yang sebelumnya dibuat dengan panggilan ke WdfDeviceCreate.

[_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 objek NETCONFIGURATION baru.

Menampilkan nilai

Fungsi ini 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 perangkat secara otomatis diinduk ke objek perangkat.

Akibatnya, WDF secara otomatis menghapus objek konfigurasi saat perangkat 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.27
Versi UMDF minimum	2.33
Header	netdevice.h (termasuk netadaptercx.h)
Pustaka	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

Lihat juga

Mengakses informasi konfigurasi