fungsi CM_Get_Device_Interface_AliasA (cfgmgr32.h)

Artikel
08/22/2023

Fungsi CM_Get_Device_Interface_Alias mengembalikan alias instans antarmuka perangkat yang ditentukan, jika alias ada.

Sintaks

CMAPI CONFIGRET CM_Get_Device_Interface_AliasA(
  [in]      LPCSTR pszDeviceInterface,
  [in]      LPGUID AliasInterfaceGuid,
  [out]     LPSTR  pszAliasDeviceInterface,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

Parameter

[in] pszDeviceInterface

Arahkan ke nama instans antarmuka perangkat untuk mengambil alias. Pemanggil biasanya menerima string ini dari panggilan ke CM_Get_Device_Interface_List, atau dalam struktur pemberitahuan PnP.

[in] AliasInterfaceGuid

Pointer ke GUID yang menentukan kelas antarmuka alias yang akan diambil.

[out] pszAliasDeviceInterface

Menentukan penunjuk ke buffer, yang setelah berhasil dikembalikan, menunjuk ke string yang berisi nama alias. Pemanggil harus membebaskan string ini ketika tidak lagi diperlukan.

Buffer diperlukan. Jika tidak, panggilan akan gagal.

[in, out] pulLength

Memasok jumlah karakter dalam pszAliasDeviceInterface dan menerima jumlah karakter yang diperlukan untuk menahan antarmuka perangkat alias.

Pada input, parameter ini harus lebih besar dari 0.

[in] ulFlags

Dicadangkan. Jangan gunakan.

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.

Menampilkan kode	Deskripsi
CR_NO_SUCH_DEVICE_INTERFACE	Mungkin menunjukkan bahwa tidak ada alias dari kelas antarmuka yang ditentukan.
CR_OUT_OF_MEMORY	Tidak ada cukup memori untuk menyelesaikan operasi.
CR_BUFFER_SMALL	Buffer yang diteruskan terlalu kecil.

Keterangan

Antarmuka perangkat dianggap alias jika diekspos oleh perangkat yang mendasar yang sama dan memiliki string referensi antarmuka yang identik, tetapi merupakan kelas antarmuka yang berbeda.

Parameter pszDeviceInterface menentukan instans antarmuka perangkat untuk perangkat tertentu, milik kelas antarmuka tertentu, dengan string referensi tertentu. CM_Get_Device_Interface_Alias mengembalikan instans antarmuka perangkat lain untuk perangkat dan string referensi yang sama, tetapi dari kelas antarmuka yang berbeda, jika ada.

Misalnya, driver fungsi untuk volume yang toleran terhadap kesalahan dapat mendaftar dan mengatur dua antarmuka perangkat, salah satu kelas antarmuka volume yang toleran terhadap kesalahan dan salah satu kelas antarmuka volume. Driver lain dapat memanggil CM_Get_Device_Interface_Alias dengan tautan simbolis untuk salah satu antarmuka dan menanyakan apakah antarmuka lain ada dengan menentukan kelas antarmukanya.

Dua antarmuka perangkat dengan string referensi NULL adalah alias jika diekspos oleh perangkat yang mendasar yang sama dan memiliki GUID kelas antarmuka yang berbeda.

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