CM_Query_Resource_Conflict_List (cfgmgr32.h)

Artikel
03/08/2023

Fungsi CM_Query_Resource_Conflict_List mengidentifikasi instans perangkat yang memiliki persyaratan sumber daya yang bertentangan dengan deskripsi sumber daya instans perangkat tertentu.

Sintaks

CMAPI CONFIGRET CM_Query_Resource_Conflict_List(
  [out]          PCONFLICT_LIST pclConflictList,
  [in]           DEVINST        dnDevInst,
  [in]           RESOURCEID     ResourceID,
  [in]           PCVOID         ResourceData,
  [in]           ULONG          ResourceLen,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

Parameter

[out] pclConflictList

Alamat lokasi yang disediakan penelepon untuk menerima handel ke daftar konflik.

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke handel mesin yang disediakan oleh hMachine.

[in] ResourceID

Pengidentifikasi jenis sumber daya yang disediakan penelepon. Ini harus menjadi salah satu konstanta awalan ResType_ yang ditentukan dalam Cfgmgr32.h.

[in] ResourceData

Penunjuk yang disediakan penelepon ke deskriptor sumber daya, yang dapat menjadi salah satu struktur yang tercantum di bawah deskripsi fungsi CM_Add_Res_DesResourceData.

[in] ResourceLen

Panjang struktur yang disediakan penelepon yang ditujukkan oleh ResourceData.

[in] ulFlags

Tidak digunakan, harus nol.

[in, optional] hMachine

Handel mesin yang disediakan penelepon yang ditangani instans perangkat yang disediakan pemanggil terikat.

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_Query_Resource_Conflict_List 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

Saat memanggil CM_Query_Resource_Conflict_List, tentukan handel instans perangkat dan pendeskripsi sumber daya. (Deskriptor sumber daya untuk simpul perangkat yang ada dapat diperoleh dengan memanggil CM_Get_Res_Des_Data.) Parameter ini menunjukkan sumber daya tertentu yang Anda inginkan untuk digunakan perangkat tertentu. Daftar konflik yang dihasilkan mengidentifikasi perangkat yang menggunakan sumber daya yang sama, bersama dengan sumber daya yang dicadangkan oleh komputer.

Setelah memanggil CM_Query_Resource_Conflict_List, aplikasi dapat memanggil CM_Get_Resource_Conflict_Count untuk menentukan jumlah konflik yang terkandung dalam daftar konflik sumber daya. (Jumlah konflik bisa nol.) Kemudian aplikasi dapat memanggil CM_Get_Resource_Conflict_Details untuk setiap entri dalam daftar konflik.

Setelah aplikasi selesai menggunakan handel yang diterima untuk pclConflictList, aplikasi harus memanggil CM_Free_Resource_Conflict_Handle.

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal atau jarak jauh, lihat CM_Get_Child_Ex.

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

Lihat juga

CM_Free_Resource_Conflict_Handle

CM_Get_Child_Ex

CM_Get_Res_Des_Data

CM_Get_Resource_Conflict_Count

CM_Get_Resource_Conflict_Details

Bagikan melalui