Udostępnij przez

Informacje o wersji programu ACX

W tym temacie omówiono informacje o wersji usług ACX i KMDF. Aby zapoznać się z ogólnym omówieniem rozszerzeń klasy audio ACX, zobacz omówienie.

Wersje usług ACX i KMDF

Use the !wdfkd.wdfldr extension to view version information for ACX. Rozszerzenie !wdfkd.wdfldr wyświetla informacje o sterownikach, które są obecnie dynamicznie powiązane ze strukturami sterowników systemu Windows.

!wdfkd.wdfldr Acx01000.sys

Version 1.1

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

Obsługa systemu operacyjnego Windows dla wersji ACX opisano w poniższej tabeli.

Operating system KMDF version Obsługiwana wersja ACX Version notes
Windows 10, wersja 2004 Minimum 1.31 1.1 Początkowa publiczna wersja.

Te identyfikatory DDI zostały dodane w wersji 1.1.

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

Wersja zapoznawcza 1.0

Wersja 1.0 nie jest zalecana w przypadku tworzenia nowych sterowników, ale była używana na wczesnym etapie opracowywania i testowania sterowników ACX.

Operating system KMDF version Obsługiwana wersja ACX Version notes
Windows 10, wersja 1903 1.29 1.0 Pre-release.

Informacje o wersji usługi KMDF

Obiekty ACX to obiekty struktury sterowników systemu Windows (WDF) — WDFOBJECT. Aby uzyskać więcej informacji na temat usługi WDF, zobacz Wprowadzenie do obiektów struktury. AcX wiąże się z określoną wersją usługi KMDF w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Historia wersji usługi KMDF.

Aby uzyskać informacje na temat instalowania różnych wersji usługi WDF/KMDF, zobacz następujące tematy:

AcX wiąże się z określoną wersją usługi KMDF w czasie wykonywania. Gdy system Windows ładuje sterownik WDF w trybie jądra, sterownik jest dynamicznie powiązany z biblioteką czasu wykonywania usługi KMDF (WdfMM000.sys). Wiele sterowników może współdzielić ten sam obraz biblioteki czasu wykonywania (DLL), a biblioteki czasu wykonywania dla dwóch głównych wersji mogą współistnieć obok siebie. Aby uzyskać informacje na temat przechowywania wersji usługi KMDF, zobacz Przechowywanie wersji biblioteki platformy.

Obsługa wielu wersji ACX

Podczas kompilowania sterownika audio należy określić maksymalną i minimalną wersję platformy ACX, której chcesz użyć w czasie kompilacji. W związku z tym sterownik audio w czasie wykonywania może zakładać, że maksymalna/minimalna wersja DDI jest dostępna, w przeciwnym razie nie można załadować sterownika audio.

Sterowniki ACX można zapisywać w celu uruchamiania na wielu wersjach ACX i w czasie wykonywania wykonać wywołanie, jeśli określony DDI ACX, struktura itp. jest obecny lub nie w tej wersji. 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.

Poniższy kod zawiera przykład sposobu sprawdzania, czy funkcja jest dostępna.

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

Dostępne są również te podobne funkcje.

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

Omówienie rozszerzeń klasy audio ACX

dokumentacja referencyjna ACX

  • Last updated on