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 mengambil nama file yang sepenuhnya memenuhi syarat (jalur direktori dan nama file) dari file INF di penyimpanan driver yang sesuai dengan file INF tertentu dalam direktori file INF sistem atau file INF tertentu di penyimpanan driver.
Sintaks
WINSETUPAPI BOOL SetupGetInfDriverStoreLocationA(
[in] PCSTR FileName,
[in, optional] PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
[in, optional] PCSTR LocaleName,
[out] PSTR 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 berikut.
[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 berikut.
[in] ReturnBufferSize
Ukuran, dalam karakter, dari buffer yang disediakan oleh ReturnBuffer.
[out, optional] RequiredSize
Penunjuk ke variabel berjenis DWORD yang menerima ukuran, dalam karakter, dari buffer ReturnBuffer . Parameter ini bersifat opsional dan dapat diatur ke NULL.
Mengembalikan nilai
Jika SetupGetInfDriverStoreLocation berhasil, fungsi mengembalikan TRUE; jika tidak, fungsi mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi 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.
Keterangan
Untuk menentukan ukuran buffer pengembalian yang diperlukan untuk berisi nama file yang sepenuhnya memenuhi syarat dari file INF yang ditentukan di penyimpanan driver, panggil SetupGetInfDriverStoreLocation dan atur ReturnBuffer ke NULL, ReturnBufferSize ke nol, dan berikan RequiredSize. SetupGetInfDriverStoreLocation akan mengembalikan ukuran buffer yang diperlukan di RequiredSize.
Ketika penginstalan perangkat telah menginstal paket driver di penyimpanan driver, itu membuat dua salinan file INF paket driver. Penginstalan perangkat menginstal satu salinan dalam direktori INF sistem dan menetapkan salinan file INF tersebut nama file unik yang diterbitkan dari 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 file INF yang sepenuhnya memenuhi syarat di penyimpanan driver yang cocok dengan file INF, jika ada, yang disediakan oleh FileName. Nama file harus menentukan nama file, dan secara opsional jalur direktori, dari file INF dalam 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 adalah Myinf.inf, dan 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 penginstal bersama 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 dari 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 file paket driver .
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.
Catatan
Header setupapi.h mendefinisikan SetupGetInfDriverStoreLocation 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 Vista dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |