fungsi CM_Add_Empty_Log_Conf (cfgmgr32.h)

Artikel
08/22/2023

Fungsi CM_Add_Empty_Log_Conf membuat konfigurasi logis kosong, untuk jenis konfigurasi tertentu dan instans perangkat tertentu, pada komputer lokal.

Sintaks

CMAPI CONFIGRET CM_Add_Empty_Log_Conf(
  [out] PLOG_CONF plcLogConf,
  [in]  DEVINST   dnDevInst,
  [in]  PRIORITY  Priority,
  [in]  ULONG     ulFlags
);

Parameter

[out] plcLogConf

Alamat lokasi untuk menerima handel ke konfigurasi logis kosong.

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.

[in] Priority

Nilai prioritas konfigurasi yang disediakan penelepon. Ini harus menjadi salah satu nilai konstanta yang tercantum dalam tabel berikut ini. Konstanta tercantum dalam urutan prioritas, dari tertinggi hingga terendah. (Untuk beberapa konfigurasi dengan nilai ulFlags yang sama, sistem akan mencoba menggunakan konfigurasi dengan prioritas tertinggi terlebih dahulu.)

Konstanta Prioritas	Definisi
LCPRI_FORCECONFIG	Hasil konfigurasi paksa.
LCPRI_BOOTCONFIG	Hasil konfigurasi boot.
LCPRI_DESIRED	Konfigurasi pilihan (performa yang lebih baik).
LCPRI_NORMAL	Konfigurasi yang dapat digunakan (performa yang dapat diterima).
LCPRI_LASTBESTCONFIG	Hanya untuk penggunaan internal.
LCPRI_SUBOPTIMAL	Bukan konfigurasi yang diinginkan, tetapi akan berfungsi.
LCPRI_LASTSOFTCONFIG	Hanya untuk penggunaan internal.
LCPRI_RESTART	Sistem harus dimulai ulang
LCPRI_REBOOT	Sistem harus dimulai ulang (sama seperti LCPRI_RESTART).
LCPRI_POWEROFF	Sistem harus dimatikan dan dimatikan.
LCPRI_HARDRECONFIG	Jumper harus diubah.
LCPRI_HARDWIRED	Konfigurasi tidak dapat diubah.
LCPRI_IMPOSSIBLE	Konfigurasi tidak dapat ada.
LCPRI_DISABLED	Konfigurasi yang dinonaktifkan.

[in] ulFlags

Bendera yang disediakan penelepon yang menentukan jenis konfigurasi logis. Salah satu bendera berikut harus ditentukan.

Bendera Jenis Konfigurasi	Definisi
BASIC_LOG_CONF	Deskriptor sumber daya yang ditambahkan ke konfigurasi ini akan menjelaskan konfigurasi dasar.
FILTERED_LOG_CONF	Jangan gunakan. (Hanya manajer PnP yang dapat membuat konfigurasi yang difilter.)
ALLOC_LOG_CONF	Jangan gunakan. (Hanya manajer PnP yang dapat membuat konfigurasi yang dialokasikan.)
BOOT_LOG_CONF	Deskriptor sumber daya yang ditambahkan ke konfigurasi ini akan menjelaskan konfigurasi boot.
FORCED_LOG_CONF	Deskriptor sumber daya yang ditambahkan ke konfigurasi ini akan menjelaskan konfigurasi paksa.
OVERRIDE_LOG_CONF	Deskriptor sumber daya yang ditambahkan ke konfigurasi ini akan menjelaskan konfigurasi penimpaan.

Salah satu bendera bit berikut dapat berupa ORed dengan bendera jenis konfigurasi.

Bendera Perbandingan Prioritas	Definisi
PRIORITY_EQUAL_FIRST	Jika beberapa konfigurasi dengan jenis yang sama (ulFlags) memiliki prioritas yang sama (Prioritas), konfigurasi ini ditempatkan di kepala daftar.
PRIORITY_EQUAL_LAST	(Default) Jika beberapa konfigurasi dengan jenis yang sama (ulFlags) memiliki prioritas yang sama (Prioritas), konfigurasi ini ditempatkan di ekor daftar.

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Catatan Dimulai dengan Windows 8, CM_Add_Empty_Log_Conf mengembalikan CR_CALL_NOT_IMPLEMENTED saat digunakan dalam skenario Wow64. Untuk meminta informasi tentang sumber daya perangkat keras pada komputer lokal, perlu menerapkan versi arsitektur asli aplikasi menggunakan API sumber daya perangkat keras. Misalnya: Aplikasi AMD64 untuk sistem AMD64.

Keterangan

Memanggil CM_Add_Empty_Log_Conf dapat menyebabkan handel yang dikembalikan oleh CM_Get_First_Log_Conf dan CM_Get_Next_Log_Conf menjadi tidak valid. Jadi, jika Anda ingin mendapatkan konfigurasi logis setelah memanggil CM_Add_Empty_Log_Conf, kode Anda harus memanggil CM_Get_First_Log_Conf lagi dan memulai pada konfigurasi pertama.

Untuk menghapus konfigurasi logis yang dibuat oleh CM_Add_Empty_Log_Conf, panggil CM_Free_Log_Conf.

Handel yang diterima di plcLogConf harus dibebaskan secara eksplisit dengan memanggil CM_Free_Log_Conf_Handle.

Penelepon fungsi ini harus memiliki SeLoadDriverPrivilege. (Hak istimewa dijelaskan dalam dokumentasi Microsoft Windows SDK.)

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal, lihat CM_Get_Child.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka	Cfgmgr32.lib
DLL	Cfgmgr32.dll