Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Fungsi SetupGetInfDriverStoreLocation
Sintaksis
WINSETUPAPI BOOL SetupGetInfDriverStoreLocationW(
[in] PCWSTR FileName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[in, optional] PCWSTR LocaleName,
[out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] FileName
Penunjuk ke string yang dihentikan NULL yang berisi nama, dan secara opsional jalur direktori lengkap, dari file INF di direktori file INF sistem. Atau, parameter ini adalah penunjuk ke string yang dihentikan NULL yang berisi nama file yang sepenuhnya memenuhi syarat (jalur direktori dan nama file) dari file INF di penyimpanan driver.
Untuk informasi selengkapnya tentang cara menentukan file INF, lihat bagian Keterangan
[in, optional] AlternatePlatformInfo
Dicadangkan untuk penggunaan sistem.
[in, optional] LocaleName
Dicadangkan untuk penggunaan sistem.
[out] ReturnBuffer
Penunjuk ke buffer di mana fungsi mengembalikan string yang dihentikan NULL yang berisi nama file yang sepenuhnya memenuhi syarat dari file INF yang ditentukan. Parameter ini dapat diatur ke NULL. Ukuran jalur maksimum yang didukung adalah MAX_PATH. Untuk informasi tentang cara menentukan ukuran buffer yang diperlukan, lihat bagian Keterangan
[in] ReturnBufferSize
Ukuran, dalam karakter, buffer yang disediakan oleh ReturnBuffer.
[out, optional] RequiredSize
Pointer ke variabel yang diketik DWORD yang menerima ukuran, dalam karakter, dari returnBuffer buffer. Parameter ini bersifat opsional dan dapat diatur ke NULL.
Mengembalikan nilai
Jika penyiapan GetInfDriverStoreLocation berhasil, fungsi mengembalikan TRUE; jika tidak, fungsi mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.
Jika ukuran, dalam karakter, dari nama file yang sepenuhnya memenuhi syarat dari file INF yang diminta, termasuk terminator null, lebih besar dari ReturnBufferSize , fungsi akan gagal, dan panggilan ke GetLastError akan mengembalikan ERROR_INSUFFICIENT_BUFFER.
Komentar
Untuk menentukan ukuran buffer pengembalian yang diperlukan untuk berisi nama file yang sepenuhnya memenuhi syarat dari file INF yang ditentukan di penyimpanan driver, panggil
Ketika penginstalan perangkat menginstal paket driver di penyimpanan driver, penginstalan membuat dua salinan file INF paket driver. Penginstalan perangkat menginstal satu salinan di direktori INF sistem dan menetapkan salinan file INF tersebut nama file unik yang diterbitkan formulir OEMnnn.inf. Penginstalan perangkat menginstal salinan kedua file INF di penyimpanan driver dan menetapkan yang menyalin nama file INF asli.
SetupGetInfDriverStoreLocation mengembalikan nama file INF yang sepenuhnya memenuhi syarat di penyimpanan driver yang cocok dengan file INF, jika ada, yang disediakan oleh FileName. Filename harus menentukan nama file, dan secara opsional jalur direktori, dari file INF di direktori INF sistem. Atau, Filename harus menentukan nama file yang sepenuhnya memenuhi syarat dari file INF di penyimpanan driver.
Misalnya, asumsikan bahwa file INF untuk paket driver Myinf.inf, dan itu untuk paket driver ini, penginstalan perangkat menginstal file INF OEM1.inf di direktori INF sistem C:\Windows\inf. Selanjutnya asumsikan bahwa penginstalan perangkat menginstal salinan file INF yang sesuai C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf di penyimpanan driver. Dalam hal ini, fungsi mengembalikan C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf jika FileName menyediakan salah satu string berikut: OEM1.inf, C:\Windows\inf\OEM1.inf, atau C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf.
penginstal kelas dan dapat menggunakan SetupGetInfDriverStoreLocation untuk mengakses file dalam paket driver yang telah diinstal sebelumnya di penyimpanan driver. Untuk menentukan jalur paket driver di penyimpanan driver, alat penginstal melakukan hal berikut:
- Panggil SetupDiGetDriverInfoDetail untuk mengambil struktur SP_DRVINFO_DETAIL_DATA untuk driver. Anggota InfFileName struktur ini berisi nama file yang sepenuhnya memenuhi syarat dari file INF driver dalam direktori INF sistem.
- Panggil SetupGetInfDriverStoreLocation dan berikan nama file yang sepenuhnya memenuhi syarat dari file INF driver yang diambil dengan memanggil SetupDiGetDriverInfoDetail. SetupGetInfDriverStoreLocation akan mengembalikan nama file yang sepenuhnya memenuhi syarat dari file INF driver di penyimpanan driver. Bagian jalur direktori dari nama file yang sepenuhnya memenuhi syarat dari file INF adalah jalur paket driver file.
CatatanPenyiapanGetInfDriverStoreLocation tidak memproses konten file INF yang ditentukan dalam FileName. Anda tidak dapat menggunakan fungsi ini untuk melakukan pencarian khusus isi untuk berkas INF di penyimpanan driver.
Nota
Header setupapi.h mendefinisikan SetupGetInfDriverStoreLocation 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 Vista dan versi Windows yang lebih baru. |
| Platform Target |
Desktop |
| Header |
setupapi.h (termasuk Setupapi.h) |
| Pustaka |
Setupapi.lib |