Fungsi SetupDiGetActualSectionToInstallA (setupapi.h)

Fungsi SetupDiGetActualSectionToInstall mengambil bagian INF DDInstall yang sesuai digunakan saat menginstal perangkat dari file INF perangkat di komputer lokal.

Sintaksis

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallA(
  [in]            HINF   InfHandle,
  [in]            PCSTR  InfSectionName,
  [out, optional] PSTR   InfSectionWithExt,
  [in]            DWORD  InfSectionWithExtSize,
  [out, optional] PDWORD RequiredSize,
  [out, optional] PSTR   *Extension
);

Parameter

[in] InfHandle

Handel ke file INF yang berisi bagian DDInstall.

[in] InfSectionName

Penunjuk ke nama bagian DDInstall (seperti yang ditentukan dalam bagian Model INF ). Panjang maksimum nama bagian, dalam karakter, adalah 254.

[out, optional] InfSectionWithExt

Penunjuk ke buffer karakter untuk menerima nama bagian DDInstall, ekstensi platformnya, dan terminator NULL. Ini adalah nama bagian yang didekorasi yang harus digunakan untuk penginstalan. Jika parameter ini null, InfSectionWithExtSize harus nol. Jika parameter ini NULL, fungsi mengembalikan TRUE dan mengatur RequiredSize ke ukuran, dalam karakter, yang diperlukan untuk mengembalikan nama bagian DDInstall, ekstensi platformnya, dan karakter NULL yang mengakhiri.

[in] InfSectionWithExtSize

Ukurannya, dalam karakter, dari buffer InfSectionWithExt. Jika infSectionWithExtNULL, parameter ini harus nol.

[out, optional] RequiredSize

Penunjuk ke variabel yang menerima ukuran, dalam karakter, yang diperlukan untuk mengembalikan nama bagian DDInstall, ekstensi platform, dan karakter NULL yang mengakhiri.

[out, optional] Extension

Penunjuk ke variabel yang menerima penunjuk ke karakter '.' yang menandai awal ekstensi di infSectionWithExt buffer. Jika buffer InfSectionWithExt tidak disediakan atau terlalu kecil, parameter ini tidak diatur. Atur parameter ini ke null jika penunjuk ke ekstensi tidak diperlukan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE. Jika fungsi gagal, fungsi mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi ini mendukung ekstensi untuk nama bagian DDInstall yang digunakan untuk menentukan perilaku penginstalan khusus OS dan arsitektur untuk perangkat. Untuk informasi tentang ekstensi ini, lihat Membuat File INF untuk Beberapa Platform dan Sistem Operasi. SetupDiGetActualSectionToInstall mencari nama bagian DDInstall yang cocok dengan komputer lokal dengan cara yang dijelaskan di bawah ini.

Fungsi pertama-tama mencari dalam file INF yang ditentukan untuk nama bagian penginstalan yang didekorasi yang cocok dengan nama yang ditentukan dan memiliki ekstensi yang cocok dengan sistem operasi dan arsitektur prosesor komputer lokal. Jika, misalnya, Anda menentukan nama bagian InstallSec, fungsi mencari salah satu nama yang didekorasi berikut, tergantung pada arsitektur prosesor komputer lokal:

• Untuk komputer yang didasarkan pada arsitektur prosesor x86, fungsi mencari nama yang didekorasi InstallSec.ntx86.
• Untuk komputer yang didasarkan pada arsitektur prosesor x64, fungsi mencari nama yang didekorasi InstallSec.ntamd64.
• Untuk komputer yang didasarkan pada arsitektur prosesor Itanium, fungsi mencari nama yang didekorasi InstallSec.ntia64.

Jika fungsi menemukan kecocokan untuk nama, sistem operasi, dan arsitektur prosesor, fungsi mengakhiri pencarian dan mengembalikan nama yang didekorasi yang sesuai. Jika fungsi tidak menemukan kecocokan seperti itu, fungsi mencari bagian yang namanya InstallSec.NT. Jika fungsi menemukan kecocokan untuk InstallSec.NT, fungsi mengakhiri pencarian dan mengembalikan nama ini. Jika fungsi tidak menemukan kecocokan untuk salah satu pencarian di atas, fungsi mengembalikan InstallSec, tetapi tidak memverifikasi bahwa file INF berisi bagian penginstalan yang namanya InstallSec.

Nama bagian DDInstall digunakan sebagai dasar untuk nama bagian Hardware dan Services. Misalnya, jika nama bagian DDInstall yang ditemukan InstallSec.NTX86, nama bagian Layanan harus diberi nama InstallSec.NTX86.Services.

Nama bagian DDInstall asli yang ditentukan dalam simpul driver ditulis ke entri nilai InfSection kunci registri driver. Ekstensi yang ditemukan disimpan dalam kunci sebagai nilai REG_SZ InfSectionExt. Misalnya:

InfSection       : REG_SZ :    "InstallSec"
InfSectionExt    : REG_SZ :    ".NTX86"

Jika driver tidak dipilih untuk elemen informasi perangkat yang ditentukan, driver null diinstal. Setelah kembali, bendera dalam struktur SP_DEVINSTALL_PARAMS perangkat menunjukkan apakah sistem harus dimulai ulang atau di-boot ulang untuk menyebabkan perangkat dimulai.

Nota

Header setupapi.h mendefinisikan SetupDiGetActualSectionToInstall 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 Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

Bagian INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice