struktur UMDF_VERSION_DATA (wudfddi_types.h)

Artikel
02/27/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.]

Struktur UMDF_VERSION_DATA menjelaskan versi kerangka kerja.

Sintaks

typedef struct UMDF_VERSION_DATA {
  ULONG MajorNumber;
  ULONG MinorNumber;
  ULONG ServiceNumber;
} UMDF_VERSION_DATA, *PUMDF_VERSION_DATA;

Anggota

MajorNumber

Angka yang menentukan versi utama kerangka kerja.

MinorNumber

Angka yang menentukan versi minor kerangka kerja.

ServiceNumber

Angka yang menentukan layanan kerangka kerja.

Keterangan

Driver UMDF memasok pointer ke struktur UMDF_VERSION_DATA ke metode IWDFDriver::IsVersionAvailable untuk menjelaskan versi minimum kerangka kerja yang didukung driver.

CatatanPeringatan: 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 Memulai UMDF.

Microsoft_WDF_UMDF_Version adalah variabel global jenis UMDF_VERSION_DATA yang menentukan versi utama, versi minor, dan nomor layanan untuk rilis kerangka kerja saat ini.

Misalnya, dalam Windows 8, Wudfddi.h menentukan:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Saat Anda mengkompilasi driver menggunakan Wudfddi.h, Microsoft_WDF_UMDF_Version disertakan dalam biner driver dan diekspor menggunakan __declspec(dllexport).

Ketika sistem memuat driver Anda, proses host (WUDFHost.exe) memverifikasi bahwa versi utama driver cocok dengan versi utama kerangka kerja dan bahwa versi minor driver kurang dari atau sama dengan versi minor kerangka kerja.

Driver tidak perlu mengambil tindakan apa pun untuk memberikan nomor versi ini ke kerangka kerja, selain membangun dengan Wudfddi.h.

Akhir dukungan: Tidak tersedia di UMDF 2.0 dan yang lebih baru.

Versi UMDF minimum: 1.0

Header: Wudfddi.h (sertakan Wudfddi.h)

Persyaratan

Persyaratan	Nilai
Header	wudfddi_types.h (termasuk Wudfddi_types.h)

Lihat juga

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version

Bagikan melalui