Fungsi SetupDiGetActualModelsSectionW (setupapi.h)
Fungsi SetupDiGetActualModelsSection mengambil bagian Model INF berdekorasi yang sesuai untuk digunakan saat menginstal perangkat dari file INF perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiGetActualModelsSectionW(
[in] PINFCONTEXT Context,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[out, optional] PWSTR InfSectionWithExt,
[in] DWORD InfSectionWithExtSize,
[out, optional] PDWORD RequiredSize,
PVOID Reserved
);
Parameter
[in] Context
Penunjuk ke konteks file INF yang menentukan entri pengidentifikasi produsen di bagian Produsen INF dari file INF. Entri pengidentifikasi produsen menentukan nama bagian Model INF dan secara opsional menentukan dekorasi TargetOSVersion untuk nama bagian Model . Untuk informasi tentang file INF dan konteks file INF, lihat topik Platform SDK tentang menggunakan file INF dan struktur INFCONTEXT.
[in, optional] AlternatePlatformInfo
Penunjuk ke struktur SP_ALTPLATFORM_INFO yang memasok informasi tentang versi Windows dan arsitektur prosesor. Anggota cbSize dari struktur ini harus diatur ke sizeof(SP_ALTPLATFORM_INFO_V2). Parameter ini bersifat opsional dan dapat diatur ke NULL.
[out, optional] InfSectionWithExt
Penunjuk ke buffer yang menerima string yang berisi nama bagian Model INF yang dihiasi dan terminator NULL. Jika AlternatePlatformInfo tidak disediakan, nama bagian Model INF yang didekorasi berlaku untuk platform saat ini; jika tidak, nama tersebut berlaku untuk platform alternatif yang ditentukan. Parameter ini bersifat opsional dan dapat diatur ke NULL. Jika parameter ini ADALAH NULL, fungsi mengembalikan TRUE dan mengatur RequiredSize ke ukuran, dalam karakter, yang diperlukan untuk mengembalikan nama bagian Model yang dihiasi dan karakter NULL yang mengakhiri.
[in] InfSectionWithExtSize
Ukuran, dalam karakter, dari buffer DecoratedModelsSection . Jika DecoratedModelsSectionadalah NULL, parameter ini harus diatur ke nol.
[out, optional] RequiredSize
Penunjuk ke variabel jenis DWORD yang menerima ukuran, dalam karakter, dari buffer DecoratedModelsSection yang diperlukan untuk mengambil nama bagian Model yang didekorasi dan karakter NULL yang mengakhiri. Parameter ini bersifat opsional dan dapat diatur ke NULL.
Reserved
Dicadangkan untuk penggunaan sistem internal. Parameter ini harus diatur ke NULL.
Mengembalikan nilai
SetupDiGetActualModelsSection mengembalikan TRUE jika operasi berhasil. Jika tidak, fungsi mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
SetupDiGetActualModelsSection menentukan bidang TargetOSVersion mana dalam entri pengidentifikasi produsen (disediakan oleh Konteks) yang berlaku untuk platform saat ini, jika AlternatePlatformInfo tidak disediakan, atau ke platform alternatif, jika informasi platform alternatif disediakan. SetupDiGetActualModelsSection memilih platform yang paling tepat berdasarkan semua bidang TargetOSVersion , menambahkan string TargetOSVersion ke nama bagian Model INF, dan mengembalikan nama bagian Model INF yang didekorasi ke pemanggil. Dalam entri pengidentifikasi produsen , versi utama sistem operasi ditentukan oleh bidang OSMajorVersion dan versi minor sistem operasi ditentukan oleh bidang OSMinorVersion .
Untuk informasi tentang mengambil bagian INF DDInstall untuk perangkat, lihat SetupDiGetActualSectionToInstall.
Catatan
Header setupapi.h mendefinisikan SetupDiGetActualModelsSection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |