Fungsi SetupDiGetActualModelsSectionA (setupapi.h)

Fungsi SetupDiGetActualModelsSection mengambil bagian Model INF yang didekorasi yang sesuai digunakan saat menginstal perangkat dari file INF perangkat.

Sintaksis

WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 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 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 menyediakan 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 inf Model yang didekorasi nama bagian dan terminator NULL. Jika AlternatePlatformInfo tidak disediakan, nama bagian inf Model 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 null, fungsi mengembalikan TRUE dan mengatur RequiredSize ke ukuran, dalam karakter, yang diperlukan untuk mengembalikan Model yang didekorasi nama bagian dan karakter NULL yang mengakhiri.

[in] InfSectionWithExtSize

Ukuran, dalam karakter, dari buffer DecoratedModelsSection . Jika DecoratedModelsSectionNULL, 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 Model yang dihiasi nama bagian 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.

Komentar

SetupDiGetActualModelsSection menentukan bidang TargetOSVersion mana dalam entri pengidentifikasi produsen (disediakan oleh Context) 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 dihiasi 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.

Nota

Header setupapi.h mendefinisikan SetupDiGetActualModelsSection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

Bagian INF DDInstall

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall