Fungsi IoGetDeviceInterfaceAlias (wdm.h)

  • Artikel

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

Sintaks

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

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

[out] AliasSymbolicLinkName

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

Nilai kembali

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

Menampilkan 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 AliasClassGuid yang tidak valid.

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

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform 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 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

IoRegisterDeviceInterface

RtlFreeUnicodeString