Sdílet prostřednictvím

Informace o verzi ACX

Toto téma popisuje informace o verzi ACX a KMDF. Obecný přehled rozšíření audio třídy ACX naleznete v tématu přehled.

Verze ACX a KMDF

Use the !wdfkd.wdfldr extension to view version information for ACX. Rozšíření !wdfkd.wdfldr zobrazuje informace o ovladačích, které jsou aktuálně dynamicky vázané na rozhraní Windows Driver Framework.

!wdfkd.wdfldr Acx01000.sys

Version 1.1

The current version of ACX is 1.1 and is recommended for all new driver development.

Podpora operačního systému Windows pro verze ACX je popsaná v následující tabulce.

Operating system KMDF version Podporovaná verze ACX Version notes
Windows 10 verze 2004 Minimum 1.31 1.1 Počáteční veřejná verze

Tyto identifikátory DDI byly přidány ve verzi 1.1.

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

Předběžná verze 1.0

Verze 1.0 se nedoporučuje pro vývoj nových ovladačů, ale byla použita v raném vývoji a testování ovladačů ACX.

Operating system KMDF version Podporovaná verze ACX Version notes
Windows 10 verze 1903 1.29 1.0 Pre-release.

Informace o verzi Služby správy klíčů

Objekty ACX jsou objekty WDF (Windows Driver Framework) – WDFOBJECT. Další informace o službě WDF naleznete v tématu Úvod do objektů framework. ACX vytvoří vazbu na konkrétní verzi KMDF za běhu. Další informace naleznete v tématu Historie verzí služby KMDF.

Informace o instalaci různých verzí WDF/KMDF najdete v následujících tématech:

ACX Vytvoří vazbu na konkrétní verzi KMDF za běhu. Když systém Windows načte ovladač WDF v režimu jádra, ovladač je dynamicky vázán na knihovnu runtime KMDF (WdfMM000.sys). Stejnou image knihovny runtime (DLL) může sdílet více ovladačů a knihovny runtime pro dvě hlavní verze můžou existovat vedle sebe. Informace o správě verzí služby KMDF naleznete v tématu Správa verzí knihovny framework.

Podpora více verzí ACX

Při sestavování zvukového ovladače zadáte maximální a minimální verzi architektury ACX, kterou chcete použít v době kompilace. Ovladač zvuku za běhu tedy může předpokládat, že je k dispozici maximální/minimální verze DDI, jinak se ovladač zvuku nenačte.

Ovladače ACX lze zapsat tak, aby běžely na více verzích ACX a v době běhu volají, pokud je v této verzi přítomna určitá funkce ACX DDI, struktura atd. ACX_IS_FUNCTION_AVAILABLE(FunctionName) can be used to see if a specific function in available in a specific version of ACX. For more information, see ACX_IS_FUNCTION_AVAILABLE macro.

Následující kód obsahuje příklad, jak zkontrolovat, jestli je funkce k dispozici.

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

K dispozici jsou také tyto podobné funkce.

ACX_IS_STRUCTURE_AVAILABLE(StructName) described in ACX_IS_STRUCTURE_AVAILABLE macro.

ACX_IS_FIELD_AVAILABLE(StructName, FieldName) described in ACX_IS_FIELD_AVAILABLE macro.

ACX also supports the ACX_DRIVER_VERSION_AVAILABLE_PARAMS_INIT function which can be used to check version information of the audio driver as shown in the following code sample.

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

See also

ACX_IS_FUNCTION_AVAILABLE macro

Přehled rozšíření zvukových tříd ACX

referenční dokumentace ACX

  • Last updated on