Metode IWDFDriver::RetrieveVersionString (wudfddi.h)

Artikel
03/01/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode RetrieveVersionString mengambil versi kerangka kerja.

Sintaks

HRESULT RetrieveVersionString(
  [out]     PWSTR pVersion,
  [in, out] DWORD *pdwVersionLength
);

Parameter

[out] pVersion

Penunjuk ke buffer yang menerima string yang dihentikan NULL yang mewakili versi kerangka kerja jika buffer yang disediakan non-NULL dan RetrieveVersionString berhasil.

[in, out] pdwVersionLength

Penunjuk ke variabel yang menerima ukuran, dalam karakter, dari string versi yang diunjukkan pVersion . Pada input, variabel ini berisi ukuran, dalam byte, dari buffer di pVersion.

Jika buffer di pVersionADALAH NULL, nilai yang disediakan driver adalah nol. Kerangka kerja kemudian mengembalikan ukuran, dalam karakter, yang diperlukan untuk string versi.

Jika buffer di pVersion bukan NULL, kerangka kerja mengembalikan ukuran, dalam karakter, dari string versi.

Nilai kembali

RetrieveVersionString mengembalikan S_OK untuk skenario berikut:

Buffer yang ditunjukkan parameter pVersion adalah non-NULL dan cukup besar untuk menahan string versi, termasuk karakter NULL . Selain itu, kerangka kerja berhasil menyalin string ke dalam buffer yang disediakan dan mengatur variabel yang diarahkan oleh parameter pdwVersionLength ke jumlah karakter dalam string.
Buffer di pVersion adalah NULL, driver mengatur variabel di pdwVersionLength ke 0, dan kerangka kerja mengatur variabel di pdwVersionLength ke jumlah karakter yang diperlukan untuk string.

RetrieveVersionString mengembalikan HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) untuk menunjukkan bahwa buffer yang disediakan bukan NULL dan tidak berisi cukup ruang untuk menyimpan versi. Kerangka kerja mengatur variabel di pdwVersionLength ke jumlah karakter yang diperlukan untuk string.

RetrieveVersionString mungkin juga mengembalikan nilai HRESULT lainnya.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Bagikan melalui