Fungsi NetConfigurationOpenSubConfiguration (netconfiguration.h)
Membuka sub konfigurasi objek konfigurasi adaptor tertentu.
Sintaks
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Parameter
[_In_] Configuration
Handel ke objek konfigurasi adaptor yang dibuka dalam panggilan sebelumnya ke NetAdapterOpenConfiguration atau NetConfigurationOpenSubConfiguration.
[_In_] SubConfigurationName
Penunjuk ke string yang menentukan nama sub konfigurasi yang akan dibuka.
[_In_opt_] SubConfigurationAttributes
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_] SubConfiguration
Penunjuk ke lokasi yang menerima handel ke objek sub konfigurasi baru.
Menampilkan nilai
Fungsi mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.
Keterangan
Jika klien menyediakan WDF_OBJECT_ATTRIBUTES, klien menentukan NULL untuk ParentObject. Secara default, sub konfigurasi diindukkan ke objek konfigurasi adaptor yang ada.
Driver klien menutup subkonfigurasi dengan memanggil NetConfigurationClose dengan objek sub konfigurasi atau objek konfigurasi adaptor induk.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.21 |
| Versi UMDF minimum | 2.33 |
| Header | netconfiguration.h (termasuk netadaptercx.h) |
| Pustaka | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |