Informasi versi ACX

  • Artikel

Topik ini membahas informasi versi ACX dan KMDF. Untuk gambaran umum ACX, lihat Gambaran umum ekstensi kelas audio ACX.

Catatan

Header dan pustaka ACX tidak disertakan dalam WDK 10.0.22621.2428 (dirilis 24 Oktober 2023), tetapi tersedia dalam versi sebelumnya, serta Pratinjau Insider terbaru (build seri 25000) WDK. Untuk informasi selengkapnya tentang versi pratinjau WDK, lihat Menginstal versi pratinjau Windows Driver Kit (WDK).

Versi ACX dan KMDF

Gunakan ekstensi !wdfkd.wdfldr untuk melihat informasi versi untuk ACX. Ekstensi !wdfkd.wdfldr menampilkan informasi tentang driver yang saat ini terikat secara dinamis ke Windows Driver Frameworks.

!wdfkd.wdfldr Acx01000.sys

Versi 1.1

Versi ACX saat ini adalah 1.1 dan direkomendasikan untuk semua pengembangan driver baru.

Dukungan OS Windows untuk versi ACX dijelaskan dalam tabel berikut.

Sistem operasi Versi KMDF Versi ACX yang didukung Catatan versi
Windows 10, version 2004 Minimum 1,31 1.1 Rilis publik awal.

DDI ini ditambahkan dalam versi 1.1.

  • AcxCircuitGetElementsCount
  • AcxCircuitGetPinsCount
  • AcxCircuitGetSymbolicLinkName
  • AcxCircuitGetNotificationId
  • AcxFactoryCircuitGetSymbolicLinkName
  • AcxDataFormatListRemoveDataFormats
  • AcxPinRemoveModeDataFormatList
  • AcxStreamGetElementsCount
  • AcxStreamGetNotificationId
  • AcxTargetCircuitGetSymbolicLinkName
  • AcxTargetPinFlushModeDataFormatListCache

Versi pra-rilis 1.0

Versi 1.0 tidak disarankan untuk pengembangan driver baru, tetapi digunakan dalam pengembangan awal dan pengujian driver ACX.

Sistem operasi Versi KMDF Versi ACX yang didukung Catatan versi
Windows 10, versi 1903 1.29 1.0 Pra-rilis.

Informasi versi KMDF

Objek ACX adalah objek Windows Driver Framework (WDF) - WDFOBJECT. Untuk informasi selengkapnya tentang WDF, lihat Pengenalan Objek Kerangka Kerja. ACX mengikat ke versi KMDF tertentu pada runtime. Untuk informasi selengkapnya, lihat Riwayat Versi KMDF.

Untuk informasi tentang menginstal versi WDF/KMDF yang berbeda, lihat topik berikut:

ACX Mengikat ke versi KMDF tertentu pada runtime. Ketika Windows memuat driver WDF mode kernel, driver secara dinamis terikat ke pustaka run-time KMDF (WdfMM000.sys). Beberapa driver dapat berbagi gambar pustaka run-time (DLL) yang sama, dan pustaka run-time untuk dua versi utama dapat berdampingan. Untuk informasi tentang penerapan versi KMDF, lihat Penerapan Versi Pustaka Kerangka Kerja.

Beberapa dukungan versi ACX

Saat Anda membuat driver audio, Anda menentukan versi maksimum dan minimum kerangka kerja ACX yang ingin Anda gunakan pada waktu kompilasi. Dengan demikian, driver audio pada waktu proses dapat mengasumsikan bahwa versi maks/min DDI tersedia, jika tidak, driver audio gagal dimuat.

Driver ACX dapat ditulis untuk berjalan pada beberapa versi ACX dan pada run-time melakukan panggilan jika ACX DDI tertentu, struktur, dll hadir atau tidak dalam versi tersebut. ACX_IS_FUNCTION_AVAILABLE(FunctionName) dapat digunakan untuk melihat apakah fungsi tertentu tersedia dalam versi ACX tertentu. Untuk informasi selengkapnya, lihat makro ACX_IS_FUNCTION_AVAILABLE.

Kode berikut, memberikan contoh tentang cara memeriksa apakah fungsi tersedia.

    if (ACX_IS_FUNCTION_AVAILABLE( AcxTargetPinFlushModeDataFormatListCache)) {
        DbgPrint("Available:  AcxTargetPinFlushModeDataFormatListCache\n");
    }
    else
    {
        DbgPrint("Not available:  AcxTargetPinFlushModeDataFormatListCache\n");
        ASSERT(FALSE);
    }

Juga tersedia adalah fungsi serupa ini.

ACX_IS_STRUCTURE_AVAILABLE(StructName) yang dijelaskan dalam makro ACX_IS_STRUCTURE_AVAILABLE.

ACX_IS_FIELD_AVAILABLE(StructName, FieldName) yang dijelaskan dalam makro ACX_IS_FIELD_AVAILABLE.

ACX juga mendukung fungsi ACX_DRIVER_VERSION_AVAILABLE_PARAMS_INIT yang dapat digunakan untuk memeriksa informasi versi driver audio seperti yang ditunjukkan dalam sampel kode berikut.

    ACX_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 1);
    if (!AcxDriverIsVersionAvailable(driver, &ver))
    {
        ASSERT(FALSE);
        goto exit;
    }

Lihat juga

makro ACX_IS_FUNCTION_AVAILABLE

Gambaran umum ekstensi kelas audio ACX

Dokumentasi referensi ACX