Fungsi SetupDiGetActualSectionToInstallW (setupapi.h)

Artikel
03/15/2023

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

Sintaks

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallW(
  [in]            HINF   InfHandle,
  [in]            PCWSTR InfSectionName,
  [out, optional] PWSTR  InfSectionWithExt,
  [in]            DWORD  InfSectionWithExtSize,
  [out, optional] PDWORD RequiredSize,
  [out, optional] PWSTR  *Extension
);

Parameter

[in] InfHandle

Handel ke file INF yang berisi bagian DDInstall .

[in] InfSectionName

Penunjuk ke nama bagian DDInstall (seperti yang ditentukan di 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

Ukuran, dalam karakter, dari buffer InfSectionWithExt . Jika InfSectionWithExt adalah NULL, 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 buffer InfSectionWithExt . Jika buffer InfSectionWithExt tidak disediakan atau terlalu kecil, parameter ini tidak diatur. Atur parameter ini ke NULL jika penunjuk ke ekstensi tidak diperlukan.

Nilai kembali

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

Keterangan

Fungsi ini mendukung ekstensi ke nama bagian DDInstall yang digunakan untuk menentukan perilaku penginstalan khusus OS dan khusus 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 akan 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 Perangkat Keras dan Layanan . Misalnya, jika nama bagian DDInstall yang ditemukan adalah 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. Contohnya:

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

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

Catatan

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

Lihat juga

Bagian Instalan INF DD

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice

Bagikan melalui