Fungsi IoGetDeviceInterfaceAlias (wdm.h)

Artikel
07/02/2025

Rutinitas IoGetDeviceInterfaceAlias mengembalikan antarmuka perangkat alias dari instans antarmuka perangkat yang ditentukan, jika alias ada.

Sintaksis

C++

NTSTATUS IoGetDeviceInterfaceAlias(
  [in]  PUNICODE_STRING SymbolicLinkName,
  [in]  const GUID      *AliasInterfaceClassGuid,
  [out] PUNICODE_STRING AliasSymbolicLinkName
);

Parameter

[in] SymbolicLinkName

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

[in] AliasInterfaceClassGuid

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

[out] AliasSymbolicLinkName

Menentukan penunjuk ke string NULL Unicode. Saat pengembalian berhasil, AliasSymbolicLinkName.Buffer menunjuk ke string yang berisi nama alias. Pemanggil harus membebaskan string Unicode dengan RtlFreeUnicodeString ketika tidak lagi diperlukan.

Mengembalikan nilai

IoGetDeviceInterfaceAlias mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan dijelaskan berikut ini.

Mengembalikan kode	Deskripsi
STATUS_OBJECT_NAME_NOT_FOUND	Mungkin menunjukkan bahwa tidak ada alias dari kelas antarmuka yang ditentukan.
STATUS_OBJECT_PATH_NOT_FOUND	Mungkin menunjukkan bahwa tidak ada alias dari kelas antarmuka yang ditentukan.
STATUS_INVALID_HANDLE	Mungkin menunjukkan SymbolicLinkName yang tidak valid atau AliasClassGuidyang tidak valid.

Komentar

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 SymbolicLinkName menentukan instans antarmuka perangkat untuk perangkat tertentu, milik kelas antarmuka tertentu, dengan string referensi tertentu. IoGetDeviceInterfaceAlias 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 IoGetDeviceInterfaceAlias dengan tautan simbolis untuk salah satu antarmuka dan bertanya 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.

Penelepon IoGetDeviceInterfaceAlias harus berjalan di IRQL = PASSIVE_LEVEL dalam konteks utas sistem.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Platform Target	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (lihat bagian Keterangan)
aturan kepatuhan DDI	HwStorPortProhibitedDIs (storport), PowerIrpDDis(wdm)

Lihat juga

IoRegisterDeviceInterface

RtlFreeUnicodeString

Bagikan melalui