Partager via

Informations de version ACX

Cette rubrique traite des informations de version ACX et KMDF. Pour obtenir une vue d’ensemble générale d’ACX, consultez vue d’ensemble des extensions de classe audio ACX.

Versions ACX et KMDF

Use the !wdfkd.wdfldr extension to view version information for ACX. L’extension !wdfkd.wdfldr affiche des informations sur les pilotes actuellement liés dynamiquement aux frameworks de pilotes Windows.

!wdfkd.wdfldr Acx01000.sys

Version 1.1

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

La prise en charge du système d’exploitation Windows pour les versions ACX est décrite dans le tableau suivant.

Operating system KMDF version Version d’ACX prise en charge Version notes
Windows 10, version 2004 Minimum 1.31 1.1 Version publique initiale.

Ces DDIS ont été ajoutées dans la version 1.1.

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

Préversion 1.0 version

La version 1.0 n’est pas recommandée pour le développement de nouveaux pilotes, mais elle a été utilisée au début du développement et des tests des pilotes ACX.

Operating system KMDF version Version d’ACX prise en charge Version notes
Windows 10, version 1903 1.29 1.0 Pre-release.

Informations sur la version de KMDF

Les objets ACX sont des objets WDF (Windows Driver Framework) - WDFOBJECT. Pour plus d’informations sur WDF, consultez Présentation des objets Framework. ACX est lié à une version spécifique de KMDF au moment de l’exécution. Pour plus d’informations, consultez l’historique des versions KMDF.

Pour plus d’informations sur l’installation de différentes versions de WDF/KMDF, consultez les rubriques suivantes :

ACX Lie à une version spécifique de KMDF au moment de l’exécution. Lorsque Windows charge un pilote WDF en mode noyau, le pilote est lié dynamiquement à la bibliothèque d’exécution KMDF (WdfMM000.sys). Plusieurs pilotes peuvent partager la même image de bibliothèque d’exécution (DLL), et les bibliothèques d’exécution pour deux versions majeures peuvent coexister côte à côte. Pour plus d’informations sur le contrôle de version KMDF, consultez Gestion des versions de la bibliothèque Framework.

Prise en charge de plusieurs versions ACX

Lorsque vous générez le pilote audio, vous spécifiez la version maximale et minimale du framework ACX que vous souhaitez utiliser au moment de la compilation. Par conséquent, le pilote audio au moment de l’exécution peut supposer que la version max/min de DDI est disponible, sinon le pilote audio ne parvient pas à se charger.

Les pilotes ACX peuvent être écrits pour s’exécuter sur plusieurs versions d’ACX et au moment de l’exécution effectuent l’appel si un DDI ACX spécifique, une structure, etc. est présent ou non dans cette version. 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.

Le code suivant fournit un exemple sur la façon de vérifier si une fonction est disponible.

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

Ces fonctions similaires sont également disponibles.

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

Vue d’ensemble des extensions de classe audio ACX

Documentation de référence relative à l’interface de ligne de commande

  • Last updated on