DEVPROP_TYPE_STRING_INDIRECT

Pengidentifikasi DEVPROP_TYPE_STRING_INDIRECT mewakili pengidentifikasi tipe data dasar untuk string Unicode yang dihentikan NULL yang berisi referensi string tidak langsung.

Keterangan

Referensi string tidak langsung menjelaskan sumber daya string yang berisi string aktual. Referensi string tidak langsung dapat muncul dalam salah satu format berikut:

@[jalur\] FileName,-ResourceID
Windows mengekstrak string dari modul yang ditentukan oleh jalur dan entri FileName , dan pengidentifikasi sumber daya string disediakan oleh entri ResourceID (tidak termasuk tanda minus yang diperlukan). Sumber daya string dimuat dari bagian sumber daya modul yang paling cocok dengan salah satu bahasa UI pilihan pemanggil. Entri jalur bersifat opsional. Jika Anda menentukan entri jalur , modul harus berada di direktori yang berada di jalur pencarian yang ditentukan sistem.

@ InfName,%strkey%
Windows mengekstrak string dari bagian String INF dari file INF dalam direktori %SystemRoot%\inf yang namanya disediakan oleh entri InfName . Pengidentifikasi token strkey harus cocok dengan kunci baris di bagian String yang paling cocok dengan salah satu bahasa UI pilihan pemanggil. Jika tidak ada bagian String khusus bahasa, Windows menggunakan bagian String default.

Anda tidak dapat menggabungkan DEVPROP_TYPE_STRING_INDIRECT dengan salah satu pengubah tipe data properti.

Mengatur Properti Tipe Ini

Untuk mengatur properti yang jenis data dasarnya DEVPROP_TYPE_STRING_INDIRECT, panggil fungsi properti SetupDiSetXxx yang sesuai dan atur parameter input fungsi sebagai berikut:

• Atur parameter PropertyType ke DEVPROP_TYPE_STRING_INDIRECT.

• Atur parameter PropertyBuffer ke penunjuk ke buffer yang berisi string yang dihentikan NULL yang menyediakan referensi string tidak langsung.

• Atur parameter PropertyBufferSize ke ukuran, dalam byte, dari string.

• Atur parameter fungsi yang tersisa yang sesuai untuk mengatur properti .

Mengambil Nilai Tipe Properti Ini

Ketika aplikasi memanggil fungsi properti SetupDiGetXxx untuk mengambil nilai properti dari jenis data dasar ini, Windows mencoba menemukan string aktual yang direferensikan properti. Jika Windows dapat mengambil string aktual, ia mengembalikan string aktual ke pemanggil dan mengidentifikasi jenis data dasar properti yang diambil sebagai DEVPROP_TYPE_STRING. Jika tidak, Windows mengembalikan referensi string tidak langsung dan mengidentifikasi jenis data dasar properti yang diambil sebagai DEVPROP_TYPE_STRING_INDIRECT.

Melokalisasi Teks Statis

Dimulai dengan Windows Vista, Anda dapat melokalisasi properti teks statis PnP tipe string kustom dan standar menggunakan sumber daya dari string gambar PE atau tabel sumber daya dengan mengatur jenis properti teks statis ke DEVPROP_TYPE_STRING_INDIRECT. Anda juga dapat menambahkan data replacement-string yang tidak dilokalkan yang dapat diformat ke dalam teks statis.

String yang terletak di sumber daya STRINGTABLE gambar PE (seperti yang biasanya dilakukan oleh LoadString) harus menggunakan format berikut:

"@"System32\mydll.dll,-21[; Fallback" String]"

"@System32\mydll.dll,-21[; String Fallback dengan %1, %2, ... ke %n[;(Arg1,Arg2,...,ArgN)]]"

String yang terletak di sumber daya tabel pesan gambar PE (seperti yang biasanya dilakukan oleh RtlFindMessage, yang lebih umum digunakan dalam driver) harus menggunakan format berikut:

"@System32\drivers\mydriver.sys,#21[; String Fallback]"

"@System32\drivers\mydriver.sys,#21[; String Fallback dengan %1, %2, ... ke %n[;(Arg1,Arg2,...,ArgN)]]"

"String Fallback" bersifat opsional tetapi berguna karena dapat dikembalikan jika sumber daya tidak dapat ditemukan atau dimuat. String fallback juga dikembalikan ke proses sistem non-interaktif yang tidak meniru pengguna, dan karenanya tidak dapat menampilkan teks yang dilokalkan kepada pengguna.

Teknik ini memungkinkan Anda untuk melokalisasi teks statis yang ditarik dari sumber daya tabel string atau pesan yang paling cocok dengan lokal pemanggil.

Windows akan memformat argumen berikutnya ke dalam string (atau string fallback) ketika diambil dari tabel sumber daya masing-masing, seperti halnya RtlFormatMessage.

Teks statis PnP tipe string kustom dan standar dilokalkan saat Anda mengatur properti dengan memuat sumber daya dari komponen yang melakukan operasi yang ditetapkan, yang biasanya terjadi di bawah lokal default sistem untuk komponen tingkat sistem.

Catatan: Gambar PE dapat menggunakan jenis tabel sumber daya (sumber daya STRINGTABLE, atau sumber daya tabel pesan).

Persyaratan

Versi	Windows Vista dan versi Windows yang lebih baru.
Header	Devpropdef.h (termasuk Devpropdef.h)

Lihat juga

DEVPROP_TYPE_STRING