Freigeben über

!acxkd

Die Erweiterung !acxkd zeigt Informationen zu ACX-Treibern (Audio Class Extension) an. Weitere Informationen zu ACX finden Sie in der Übersicht über ACX-Audioklassenerweiterungen.

Syntax

!acxkd.[Options]

DLL

Acxkd.dll

Debuggerversion

Die Erweiterung !acxkd ist in WinDbg, Version 1.2402.24001.0 und höher, verfügbar.

ACX 1.0-Debugging

Die Debuggererweiterung !acxkd bietet nur teilweise Funktionalität unter ACX 1.0. Das Aktualisieren auf ACX 1.1 wird empfohlen.

Parameter

Optionen – Gibt den Typ der anzuzeigenden Informationen an.

Option Beschreibung Parameter
!help Zeigt Informationen zu verfügbaren Erweiterungsbefehlen an. [<command name>]
!acxcircuit Abbilden eines ACXCIRCUIT-Objekts. <circuit> - ACXCIRCUIT-WDF-Handle
!acxdataformat Abbilden eines ACXDATAFORMAT-Objekts. <dataformat> - ACXDATAFORMAT-WDF-Handle
!acxdataformatlist Abbilden eines ACXDATAFORMATLIST-Objekts. <dataformatlist> - ACXDATAFORMATLIST-WDF-Handle
!acxdevice Abbilden eines ACXDEVICE-Objekts. <device> - ACXDEVICE-WDF-Handle
!acxelement Abbilden eines ACXELEMENT-Objekts. <element> - ACXELEMENT-WDF-Handle
!acxevents Abbildereignisse eines ACXOBJECT-Objekts. <events> - ACXOBJECT-WDF-Handle
!acxfactory Abbilden eines ACXFACTORYCIRCUT-Objekts. <factory> - ACXFACTORYCIRCUIT-WDF-Handle
!acxmanager Abbilden eines ACXMANAGER-Objekts. Keine
!acxmethods Dumpmethoden eines ACXOBJECT-Objekts. <object> - ACXOBJECT-WDF-Handle
!acxobjbag Abbilden eines ACXOBJECTBAG-Objekts. <objbag> - ACXOBJECTBAG-WDF-Handle
!acxobject Abbilden eines ACXOBJECT-Objekts. <object> - ACXOBJECT-WDF-Handle
!acxpin Abbilden eines ACXPIN-Objekts. <pin> - ACXPIN-WDF-Handle
!acxproperties Dumpeigenschaften eines ACXOBJECT-Objekts. <properties> - ACXOBJECT-WDF-Handle
!acxstream Abbilden eines ACXSTREAM-Objekts. <stream> - ACXSTREAM-Handle
!acxstreambridge Abbilden eines ACXSTREAMBRIDGE-Objekts. <bridge> - ACXSTREAMBRIDGE-Handle
!acxtarget Abbilden eines ACXTARGET-Objekts. <target> - ACXTARGET-WDF-Handle
!acxtemplate Abbilden eines ACXTEMPLATE-Objekts. <tmpt> - ACXTEMPLATE-Handle

Hinweise

!acxkd.help

Verwenden Sie den Befehl "acxkd !help ", um alle verfügbaren Befehle auflisten zu können.

0: kd> !acxkd.help
Commands for C:\Debugger\acxkd.dll:
  !acxcircuit        - Dump a ACXCIRCUT object.
  !acxdataformat     - Dump a ACXDATAFORMAT object.
  !acxdataformatlist - Dump a ACXDATAFORMATLIST object.
  !acxdevice         - Dump a ACXDEVICE object.
  !acxelement        - Dump a ACXELEMENT object.
  !acxevents         - Dump events of a ACXOBJECT object.
  !acxfactory        - Dump a ACXFACTORYCIRCUT object.
  !acxmanager        - Dump a ACXMANAGER object.
  !acxmethods        - Dump methods of a ACXOBJECT object.
  !acxobjbag         - Dump a ACXOBJECTBAG object.
  !acxobject         - Dump a ACXOBJECT* object.
  !acxpin            - Dump a ACXPIN object.
  !acxproperties     - Dump properties of a ACXOBJECT object.
  !acxstream         - Dump a ACXSTREAM object.
  !acxstreambridge   - Dump a ACXSTREAMBRIDGE object.
  !acxtarget         - Dump a ACXTARGET* object.
  !acxtemplate       - Dump a ACX*TEMPLATE object.
  !help              - Displays information on available extension commands
!help <cmd> will give more information for a particular command

Verwenden Sie den Befehl "acxkd !help ", um mehr über einen der Befehle zu erfahren, z. B. den !acxdevice Befehl.

0: kd> !acxkd.help acxdevice
!acxdevice <device>
  <device> - ACXDEVICE handle
Dump a ACXDEVICE object.

Verwenden Sie den Befehl "!acxdevice" als Ausgangspunkt, um den ACX-Treiber zu untersuchen.

3: kd> !acxdevice 0x00007dfadb0a5358
Dumping info for ACXDEVICE 0x00007dfadb0a5358

    In connected standby: FALSE

    State: AfxDeviceStateInitialized
    State history:
        0 : AfxDeviceStateInvalid
        1 : AfxDeviceStateInvalid
        2 : AfxDeviceStateInvalid
        3 : AfxDeviceStateInvalid
        4 : AfxDeviceStateInvalid
        5 : AfxDeviceStateCreated
        6 : AfxDeviceStateInitializing
        7 : AfxDeviceStateInitialized

    Create dispatch list:
        Create name: eHDMIOutTopo
        Dispatch routine: fffff80393179918
        Dispatch context: ffff82052513b960

    Circuits:
        ----------------------------------

        [Circuit 0]

        Name: eHDMIOutTopo
        Type: AcxCircuitTypeRender
        ComponentId: {BFCA9AD9-4EED-46C2-9323-B5D4400761A5}

        State: AfxCircuitStatePoweredUp

        Interface is enabled
        SymolicLinkName: \??\HDAUDIO#SUBFUNC_01&VEN_8086&DEV_281F&NID_0001&SUBSYS_00000000&REV_1000#6&4948348&0&0002&00000025#{2c6bb644-e1ae-47f8-9a2b-1d1fa750f2fa}\eHDMIOutTopo

        !acxproperties 00007dfad9ccccb8
        !acxmethods 00007dfad9ccccb8
        !acxevents 00007dfad9ccccb8

        # Pins: 2
            !acxpin 00007dfadf996dd8
            !acxpin 00007dfad4697238

        # Elements: 1
            !acxelement 00007dfadf997a18

        # Streams: 0

        !acxcircuit 00007dfad9ccccb8

    !wdfqueue 00007dfade9beaf8
    !wdfdevice 00007dfadb0a5358

    !wdfhandle 00007dfadb0a5358
    dt Acx01000!Acx::AfxDevice ffff8205256ab420

Klicken Sie auf die Links in der Ausgabe, um Informationen mithilfe der Befehle !acxproperties, !acxmethods und !acxevents anzuzeigen.

Informationen zum Auffinden des wdfhandle für das ACXDEVICE-Objekt finden Sie in der exemplarischen Vorgehensweise des BEISPIEL-ACX-Treibers in diesem Artikel.

WDF-Befehle - !wdfkd.wdfldr

Da ACX-Treiber WDF-Treiber sind, verwenden Sie einen der WDF-Kerneldebuggerbefehle. Verwenden Sie z. B. !wdfkd.wdfldr , um Versionsinformationen und die ACX-Bindung mit WDF anzuzeigen.

0: kd> !wdfldr acx01000
WDF Driver: Acx01000
----------------------------------
CLIENT_MODULE   0xffff82052abdcbc0
  WDF Version   v1.31
  ImageName     Acx01000.sys
  ImageAddress  0xfffff80393150000
  ImageSize     0xb3000
  BindingList   0xffff82052abdcc08

  ImageName        WdfVer Ver   WdfGlobals         BindInfo           ImageAddress       ImageSize
  Wdf01000.sys     v1.33  v1.33 0xffff8205218d8fb0 0xffff8205218d8df0 0xfffff80356a00000 0x000c7000
----------------------------------
CLASS_MODULE    0xffff820525b3dc90
  WDF Version   v1.31
  Version       v1.1
  Service       \Registry\Machine\System\CurrentControlSet\Services\acx01000
  ImageName     Acx01000.sys
  ImageAddress  0xfffff80393150000
  ImageSize     0xb3000
  ClientsList   0xffff820525b3dcf8
  Associated Clients: 1

  ImageName        WdfVer Ver   WdfGlobals         BindInfo           ImageAddress       ImageSize
  AcxHdAudio.sys   v1.25  v1.0  0xffff820527f70ae0 0xfffff803930df3e8 0xfffff803930c0000 0x0008a000
----------------------------------

!acxkd.acxmanager

Verwenden Sie den !acxmanager Befehl, um Informationen zum ACXMANAGER-Objekt anzuzeigen. Dies bietet einen guten Ausgangspunkt, um ACX-Treiber zu untersuchen.

Dieses Beispiel zeigt den ersten Teil der umfangreichen !acxmanager Ausgabe für eine multiitcircuit ACX-Konfiguration.

10: kd> !acxmanager
Dumping info for ACXMANAGER 0x000054f94d1d4378

    Delete pending: No

    # singleton composites: 8
        ----------------------------------

        [Composite 0]

        State: AfxCompositeStateActive
        !acxobjbag 000054f94c8e61c8
        !acxtemplate 000054f94c014d28
        !acxobject 000054f94c0141c8

        # circuits: 3
            ----------------------------------
            [Circuit 0 CORE]
…

Diese Beispielausgabe zeigt einen einzelnen ACX-Schaltkreis.

0: kd> !acxmanager
Dumping info for ACXMANAGER 0x000049f6c3c769f8

    Delete pending: No

    # singleton composites: 0
    # Composite factories: 0
    !wdfhandle 000049f6c3c769f8
    dt Acx01000!Acx::AfxManager ffffb6093c3896b0

!acxkd.acxobject

In der Ausgabe für den !acxmanager wird für das wdfhandle eine Adresse angegeben. Verwenden Sie die Wdfhandle-Adresse mit dem !acxobject Befehl, um Informationen zum ACXMANAGER oder einem anderen ACX-Objekt anzuzeigen.

0: kd> !acxobject 000049f6c3c769f8
Dumping info for ACXMANAGER 0x000049f6c3c769f8

    Delete pending: No

    # singleton composites: 0
    # Composite factories: 0
    !wdfhandle 000049f6c3c769f8
    dt Acx01000!Acx::AfxManager ffffb6093c3896b0

Klicken Sie auf den Link in der dt oben gezeigten Ausgabe, um weitere Informationen zu den internen ACX-Objektstrukturen anzuzeigen.

0: kd> dt Acx01000!Acx::AfxManager ffffb6093c3896b0
   +0x000 m_Object         : 0x000049f6`c3c769f8 ACXMANAGER__
   =fffff803`8a478ad8 s_AfxManager     : 0xffffb609`3c3896b0 Acx::AfxManager
   +0x008 m_AcxGlobals     : 0xffffb609`403cae24 _ACX_DRIVER_GLOBALS
   +0x010 m_Flags          : 0
   +0x010 m_Unloading      : 0y0
   +0x018 m_CompositesMutex : _FAST_MUTEX
   +0x050 m_CompositeFactoriesList : _LIST_ENTRY [ 0xffffb609`3c389700 - 0xffffb609`3c389700 ]
   +0x060 m_CompositeFactoriesCount : 0n0
   +0x068 m_CompositesList : _LIST_ENTRY [ 0xffffb609`3c389718 - 0xffffb609`3c389718 ]
   +0x078 m_CompositesCount : 0n0
   +0x080 m_FactoriesList  : _LIST_ENTRY [ 0xffffb609`3c389730 - 0xffffb609`3c389730 ]
   +0x090 m_CircuitsList   : _LIST_ENTRY [ 0xffffb609`40a27068 - 0xffffb609`40a27068 ]
   +0x0a0 m_FiltersMutex   : _FAST_MUTEX
   +0x0d8 m_FactoryFiltersList : _LIST_ENTRY [ 0xffffb609`3c389788 - 0xffffb609`3c389788 ]
   +0x0e8 m_CircuitFiltersList : _LIST_ENTRY [ 0xffffb609`3c389798 - 0xffffb609`3c389798 ]
   +0x0f8 m_FactoriesNotificationHandle : 0xffffc70c`b2356790 Void
   +0x100 m_CircuitsNotificationHandle : 0xffffc70c`b2357ec0 Void
   +0x108 m_CommandQueue   : 0xffffb609`3ffc5400 Acx::AfxWorkQueue

Beachten Sie, dass die Debuggerausgabe eine Mischung aus öffentlichen ACX-Objekten wie ACXMANAGER, ACXCIRCUITFACTORY und ACXCIRCUIT und internen Strukturen enthalten kann, die als undurchsichtig definiert sind. Die internen Typen sind nicht garantiert, gleich zu bleiben oder in verschiedenen Versionen von ACX verfügbar zu sein und dürfen nicht direkt aufgerufen oder verwendet werden.

Da ACX-Objekte WDF-Objekte sind, können Sie den Befehl "!wdfkd.wdfhandle " verwenden, um zusätzliche Informationen zum ACXMANAGER-Objekt anzuzeigen.

0: kd> !wdfhandle 000049f6c3c769f8
Treating handle as a KMDF handle!

Dumping WDFHANDLE 0x000049f6c3c769f8
=============================
Handle type is WDFOBJECT [ACXMANAGER]
Refcount: 2
Contexts:
    context:  dt 0xffffb6093c3896b0 Acx01000!AfxManager (size is 0x110 bytes)
    EvtCleanupCallback fffff8038a453070 Acx01000!Acx::WdfCpp::ObjectContext<ACXMANAGER__ *,Acx::AfxManager>::EvtObjectContextCleanupThunk
    EvtDestroyCallback fffff8038a453000 Acx01000!Acx::WdfCpp::ObjectContext<ACXMANAGER__ *,Acx::AfxManager>::EvtObjectContextDestroyThunk

    context:  dt 0xffffb609404c2280 Acx01000!WdfCustomType_ACXMANAGER (size is 0x10 bytes)
    <no associated attribute callbacks>

Parent: !wdfhandle 0x000049f6d4e2d5c8, type is WDFDEVICE
Owning device: !wdfdevice 0x000049f6d4e2d5c8

!wdfobject 0xffffb6093c389600

!acxkd.acxpin

Befehle, die andere ACX-Informationen anzeigen, z !acxpin . B. ein WDF-Handle für das Objekt erfordern. Informationen zum Auffinden des WDF-Handles für ein ACX-Objekt finden Sie in diesem Artikel im Beispiel für ACX-Treiber .

0: kd> !acxpin 0x000049f6befeee38
Dumping info for ACXPIN 0x000049f6befeee38

    ID: 0
    Type: AcxPinTypeSink
    Type: AcxPinCommunicationSink

    Category: KSCATEGORY_AUDIO
    Name: {00000000-0000-0000-0000-000000000000}

Je nach Status des ACX-Objekts stehen möglicherweise nicht alle Informationen zur Anzeige zur Verfügung.

!acxkd.acxdataformatlist

Ähnlich wie !acxpin !acxdataformatlist werden Informationen zu ACX-Datenformatlisten angezeigt.

0: kd> !acxdataformatlist 0x000049f6bf8be668
Dumping info for ACXDATAFORMATLIST 0x000049f6bf8be668

    # Scan count: 0
    # Data formats: 6
    Data formats:
        Sample Rate: 48000, #Channels: 2, #Bits: 16, ValidBits: 16, Mask: 0x3 (default)
        Sample Rate: 48000, #Channels: 2, #Bits: 32, ValidBits: 24, Mask: 0x3
        Sample Rate: 44100, #Channels: 2, #Bits: 16, ValidBits: 16, Mask: 0x3
        Sample Rate: 44100, #Channels: 2, #Bits: 32, ValidBits: 24, Mask: 0x3
        Sample Rate: 32000, #Channels: 2, #Bits: 16, ValidBits: 16, Mask: 0x3
        Sample Rate: 32000, #Channels: 2, #Bits: 32, ValidBits: 24, Mask: 0x3

    !wdfhandle 000049f6bf8be668
    dt Acx01000!Acx::AfxDataFormatList ffffb60940444530

Beispiel für exemplarische Vorgehensweise für ACX-Treiber

Dieser Abschnitt enthält eine exemplarische Vorgehensweise zum Debuggen eines ACX-Treibers.

Symbolpfad

Verwenden Sie .symfix und die .sympath-Befehle (Set Symbol Path), um den Symbolpfad zu ändern. Wenn Sie lokalen Code mit dem Treiber verwenden, fügen Sie auch den Pfad zu diesem Code hinzu. Verwenden Sie den Befehl .reload (Reload Module), um Symbole aus dem aktuellen Pfad neu zu laden.

.symfix
.sympath+ C:\Windows-driver-samples-develop\audio\Acx\Samples\AudioCodec\Driver
.reload /f

Debuggerkontext für Treiber

Wenn Sie einen aktiven ACX-Treiber debuggen, legen Sie einen Haltepunkt fest. Dadurch wird der Debugger im Kontext der ACX-Objekte platziert, um Informationen zu sammeln und anzuzeigen.

Diese Beispiel-Haltepunkte sind so konzipiert, dass sie ausgelöst werden, wenn der AudioCodec-Beispieltreiber gestartet wird.

bm AudioCodec!DriverEntry
bm AudioCodec!AcxDriverInitialize

Diese Beispiel-Haltepunkte sind so konzipiert, dass sie ausgelöst werden, wenn bestimmte Aktionen auftreten, z. B. Pin- oder Schaltkreiserstellung.

bm AudioCodec!AcxPinCreate
bm AudioCodec!AcxCircuitCreate
bm AudioCodec!Codec_EvtBusDeviceAdd

Nachdem der Treiber geladen wurde und der entsprechende Haltepunkt ausgelöst wurde, und gültiger Ausführungskontext verfügbar ist, verwenden Sie !acxkd-Befehle, um Informationen zu jedem ACX-Objekt anzuzeigen. Verwenden Sie den Befehl "!acxobject" für allgemeine Informationen und einen bestimmten Befehl, z. B. "!acxcircuit" oder "!acxpin", um genauere Informationen zu erfahren.

Laden der acxkd-DLL

Verwenden Sie den Befehl .load (Load Extension DLL), um die acxkd.dll Erweiterung zu laden.

.load acxkd.dll

Anzeigen von Informationen zum ACX-Treiber

Um Informationen zum Zieltreiber zu sammeln, verwenden Sie den LM-Befehl (Geladene Module auflisten), um alle geladenen Treiber anzuzeigen. Verwenden Sie dann die Dvm-Optionen, um Informationen über den ACX-Treiber anzuzeigen, der von Interesse ist, wie hier gezeigt.

0: kd> lm Dvm AcxHdAudio
Browse full module list
start             end                 module name
fffff803`8a3c0000 fffff803`8a448000   AcxHdAudio   (private pdb symbols)  C:\ProgramData\Dbg\sym\AcxHdAudio.pdb\6AEA2622909B20C1AD149C57ACBB4A6F1\AcxHdAudio.pdb
    Loaded symbol image file: AcxHdAudio.sys
    Mapped memory image file: C:\ProgramData\Dbg\sym\AcxHdAudio.sys\0829423388000\AcxHdAudio.sys
    Image path: \SystemRoot\System32\drivers\AcxHdAudio.sys
    Image name: AcxHdAudio.sys
    Browse all global symbols  functions  data  Symbol Reload
    Image was built with /Brepro flag.
    Timestamp:        08294233 (This is a reproducible build file hash, not a timestamp)
    CheckSum:         00087DD6
    ImageSize:        00088000
    Translations:     0000.04b0 0000.04e4 0409.04b0 0409.04e4
    Information from resource tables:

Verwenden Sie den Befehl "x" (Symbole untersuchen) und ein Wildcardformat, um bestimmte ACX-Strukturen anzuzeigen, z. B. eine ACXPIN-

0: kd> x /D AcxHdAudio!acxpin*
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

fffff803`8a3e3216 AcxHdAudio!AcxPinGetRawDataFormatList =  (inline caller) AcxHdAudio!HDACodec_EvtFormatChange+66
fffff803`8a3e31e0 AcxHdAudio!AcxPinGetCircuit =  (inline caller) AcxHdAudio!HDACodec_EvtFormatChange+30
fffff803`8a3e361f AcxHdAudio!AcxPinNotifyDataFormatChange =  (inline caller) AcxHdAudio!HDACodec_EvtFormatChange+46f
fffff803`8a3e7396 AcxHdAudio!AcxPinCreate =  (inline caller) AcxHdAudio!HDACodecR_CreateRenderCircuit+962
fffff803`8a3e74a2 AcxHdAudio!AcxPinGetRawDataFormatList =  (inline caller) AcxHdAudio!HDACodecR_CreateRenderCircuit+a6e
fffff803`8a3e75f8 AcxHdAudio!AcxPinCreate =  (inline caller) AcxHdAudio!HDACodecR_CreateRenderCircuit+bc4
fffff803`8a3e789a AcxHdAudio!AcxPinAddJacks =  (inline caller) AcxHdAudio!HDACodecR_CreateRenderCircuit+e66
fffff803`8a3e5ae5 AcxHdAudio!AcxPinGetCircuit =  (inline caller) AcxHdAudio!HDACodecR_EvtAcxPinRetrieveJackSinkInfo+25
fffff803`8a3e5913 AcxHdAudio!AcxPinGetCircuit =  (inline caller) AcxHdAudio!HDACodecR_EvtAcxPinRetrieveName+73
fffff803`8a3ea277 AcxHdAudio!AcxPinCreate =  (inline caller) AcxHdAudio!HDACodecC_CreateCaptureCircuit+b27
fffff803`8a3ea39c AcxHdAudio!AcxPinGetRawDataFormatList =  (inline caller) AcxHdAudio!HDACodecC_CreateCaptureCircuit+c4c
fffff803`8a3ea4bc AcxHdAudio!AcxPinCreate =  (inline caller) AcxHdAudio!HDACodecC_CreateCaptureCircuit+d6c
fffff803`8a3ea7b2 AcxHdAudio!AcxPinAddJacks =  (inline caller) AcxHdAudio!HDACodecC_CreateCaptureCircuit+1062

Je nach dem aktuellen Ausführungskontext im Debugger kann es möglich sein, den DX (Anzeigedebuggerobjektmodellausdruck) zu verwenden, um einen Drilldown zu bestimmten ACX-Strukturen durchzuführen.

0: kd> dx -r2 AudioCodec!AcxDeviceAddCircuit
AudioCodec!AcxDeviceAddCircuit                 : AudioCodec!AcxDeviceAddCircuit+0x0 [Type: long __cdecl(WDFDEVICE__ *,ACXCIRCUIT__ *)]
0: kd> u fffff8007ead1120
AudioCodec!AcxDeviceAddCircuit [C:\Program Files (x86)\Windows Kits\10\Include\10.0.26016.0\km\acx\km\1.1\AcxDevice.h @ 206]:
fffff800`7ead1120 4889542410      mov     qword ptr [rsp+10h],rdx
fffff800`7ead1125 48894c2408      mov     qword ptr [rsp+8],rcx
fffff800`7ead112a 4883ec38        sub     rsp,38h
fffff800`7ead112e b808000000      mov     eax,8
fffff800`7ead1133 486bc046        imul    rax,rax,46h
fffff800`7ead1137 488d0dc2ab0000  lea     rcx,[AudioCodec!AcxFunctions (fffff800`7eadbd00)]
fffff800`7ead113e 488b0401        mov     rax,qword ptr [rcx+rax]
fffff800`7ead1142 4889442420      mov     qword ptr [rsp+20h],rax

!wdfkd.wdfdriverinfo

Verwenden Sie den Befehl "!wdfdriverinfo " mit dem Namen des Treibers, um WDF-Informationen zu sammeln, z. B. die zugeordneten ACX-Objekte und ACXDEVICE-Wdfhandle.

0: kd> !wdfdriverinfo AcxHdAudio.sys 1 -v 
----------------------------------
Default driver image name: AcxHdAudio
WDF library image name: Wdf01000
 FxDriverGlobals  0xffffb609403e3de0
 WdfBindInfo      0xfffff8038a3dd1b0
   Version        v1.25
 Library module   0xffffb60929cc6050
   ServiceName    \Registry\Machine\System\CurrentControlSet\Services\Wdf01000
   ImageName      Wdf01000
----------------------------------
WDFDRIVER: 0x000049f6bfe9d5d8
    context:  dt 0xffffb60940162bc0 AcxHdAudio!CODEC_DRIVER_CONTEXT (size is 0x1 bytes)
    <no associated attribute callbacks>

    context:  dt 0xffffb6093ccead20 Acx01000!AfxDriver (size is 0x20 bytes)
    EvtCleanupCallback fffff8038a455780 Acx01000!Acx::WdfCpp::ObjectContext<WDFDRIVER__ *,Acx::AfxDriver>::EvtObjectContextCleanupThunk
    EvtDestroyCallback fffff8038a455740 Acx01000!Acx::WdfCpp::ObjectContext<WDFDRIVER__ *,Acx::AfxDriver>::EvtObjectContextDestroyThunk
Object Hierarchy: !wdfhandle 0x000049f6bfe9d5d8 0xff
Driver logs: !wdflogdump AcxHdAudio.sys -d
Framework logs: !wdflogdump AcxHdAudio.sys -f

    !wdfdevice 0x000049f6bffba488 ff (FDO)
        Pnp/Power State: WdfDevStatePnpStarted, WdfDevStatePowerD0, WdfDevStatePwrPolStartedWakeCapable
        context:  dt 0xffffb60940045e60 AcxHdAudio!CODEC_DEVICE_CONTEXT (size is 0x110 bytes)
        EvtCleanupCallback fffff8038a3e3c90 AcxHdAudio!HDACodec_EvtDeviceContextCleanup

        context:  dt 0xffffb60933f030f0 Acx01000!AfxDevice (size is 0x150 bytes)
        EvtCleanupCallback fffff8038a451910 Acx01000!Acx::WdfCpp::ObjectContext<WDFDEVICE__ *,Acx::AfxDevice>::EvtObjectContextCleanupThunk
        EvtDestroyCallback fffff8038a451740 Acx01000!Acx::WdfCpp::ObjectContext<WDFDEVICE__ *,Acx::AfxDevice>::EvtObjectContextDestroyThunk

        context:  dt 0xffffb60940a26b90 AcxHdAudio!CODEC_RENDER_DEVICE_CONTEXT (size is 0x38 bytes)
        <no associated attribute callbacks>

        context:  dt 0xffffb609409f2e00 AcxHdAudio!CODEC_CAPTURE_DEVICE_CONTEXT (size is 0x8 bytes)
        <no associated attribute callbacks>
        !wdfdevicequeues 0x000049f6bffba488

        !wdfdevice 0x000049f6bef1a848 ff (PDO)
            Pnp/Power State: WdfDevStatePnpStarted, WdfDevStatePowerD0BusWakeOwner, WdfDevStatePwrPolStartedWakeCapable
            context:  dt 0xffffb609410e5aa0 AcxHdAudio!CODEC_RENDER_DEVICE_CONTEXT (size is 0x38 bytes)
            EvtCleanupCallback fffff8038a3e6400 AcxHdAudio!HDACodecR_EvtDeviceContextCleanup

            context:  dt 0xffffb60933f090d0 Acx01000!AfxDevice (size is 0x150 bytes)
            EvtCleanupCallback fffff8038a451910 Acx01000!Acx::WdfCpp::ObjectContext<WDFDEVICE__ *,Acx::AfxDevice>::EvtObjectContextCleanupThunk
            EvtDestroyCallback fffff8038a451740 Acx01000!Acx::WdfCpp::ObjectContext<WDFDEVICE__ *,Acx::AfxDevice>::EvtObjectContextDestroyThunk
            !wdfdevicequeues 0x000049f6bef1a848

----------------------------------

WDF Verifier settings for AcxHdAudio.sys is OFF
----------------------------------

In der oben gezeigten Ausgabe ist ein Link für die zugeordnete wdfdevice verfügbar. Klicken Sie auf diesen Link, um Informationen zu den zugeordneten WDF-Geräteobjekten anzuzeigen.

0: kd> !wdfdevice 0x000049f6bef1a848 ff
Treating handle as a KMDF handle!

Dumping WDFDEVICE 0x000049f6bef1a848
=================================

WDM PDEVICE_OBJECTs:  self ffffb60940ddbdd0

Pnp state:  119 ( WdfDevStatePnpStarted )
Power state:  309 ( WdfDevStatePowerD0BusWakeOwner )
Power Pol state:  531 ( WdfDevStatePwrPolStartedWakeCapable )

!acxkd.acxdevice

Die Verwendung desselben Wdfhandle mit !acxdevice ACX-zentrierten Informationen.

3: kd> !acxdevice 0x00007dfadb0a5358
Dumping info for ACXDEVICE 0x00007dfadb0a5358

    In connected standby: FALSE

    State: AfxDeviceStateInitialized
    State history:
        0 : AfxDeviceStateInvalid
        1 : AfxDeviceStateInvalid
        2 : AfxDeviceStateInvalid
        3 : AfxDeviceStateInvalid
        4 : AfxDeviceStateInvalid
        5 : AfxDeviceStateCreated
        6 : AfxDeviceStateInitializing
        7 : AfxDeviceStateInitialized

    Create dispatch list:
        Create name: eHDMIOutTopo
        Dispatch routine: fffff80393179918
        Dispatch context: ffff82052513b960

    Circuits:
        ----------------------------------

        [Circuit 0]

        Name: eHDMIOutTopo
        Type: AcxCircuitTypeRender
        ComponentId: {BFCA9AD9-4EED-46C2-9323-B5D4400761A5}

        State: AfxCircuitStatePoweredUp

        Interface is enabled
        SymolicLinkName: \??\HDAUDIO#SUBFUNC_01&VEN_8086&DEV_281F&NID_0001&SUBSYS_00000000&REV_1000#6&4948348&0&0002&00000025#{2c6bb644-e1ae-47f8-9a2b-1d1fa750f2fa}\eHDMIOutTopo

        !acxproperties 00007dfad9ccccb8
        !acxmethods 00007dfad9ccccb8
        !acxevents 00007dfad9ccccb8

        # Pins: 2
            !acxpin 00007dfadf996dd8
            !acxpin 00007dfad4697238

        # Elements: 1
            !acxelement 00007dfadf997a18

        # Streams: 0

        !acxcircuit 00007dfad9ccccb8

    !wdfqueue 00007dfade9beaf8
    !wdfdevice 00007dfadb0a5358

    !wdfhandle 00007dfadb0a5358
    dt Acx01000!Acx::AfxDevice ffff8205256ab420

Verwenden Sie zum Anzeigen von Informationen zu den anderen ACX-Objekten, z. B. acXCIRCUIT, den Link oben, der mit dem entsprechenden Wdfhandle aufgerufen wird !acxcircuit .

3: kd> !acxcircuit 00007dfad9ccccb8
Dumping info for ACXCIRCUIT 0x00007dfad9ccccb8

    Name: eHDMIOutTopo
    Type: AcxCircuitTypeRender
    ComponentId: {BFCA9AD9-4EED-46C2-9323-B5D4400761A5}

    State: AfxCircuitStatePoweredUp
    State history:
        0 : AfxCircuitStateInvalid
        1 : AfxCircuitStateInvalid
        2 : AfxCircuitStateInvalid
        3 : AfxCircuitStateCreated
        4 : AfxCircuitStateInitializing
        5 : AfxCircuitStateInitialized
        6 : AfxCircuitStatePoweredDown
        7 : AfxCircuitStatePoweredUp

    Interface is enabled
    SymolicLinkName: \??\HDAUDIO#SUBFUNC_01&VEN_8086&DEV_281F&NID_0001&SUBSYS_00000000&REV_1000#6&4948348&0&0002&00000025#{2c6bb644-e1ae-47f8-9a2b-1d1fa750f2fa}\eHDMIOutTopo

    # Power references: 0
    # Open handles: 18

    !acxproperties 00007dfad9ccccb8
    !acxmethods 00007dfad9ccccb8
    !acxevents 00007dfad9ccccb8

    # Pins: 2
        !acxpin 00007dfadf996dd8
        !acxpin 00007dfad4697238

    # Elements: 1
        !acxelement 00007dfadf997a18

!acxkd.acxproperties

In den Ausgabebefehlslinks mit dem wdfhandle werden für andere Objekte wie ACX-Eigenschaften bereitgestellt, die angezeigt werden können.

0: kd> !acxproperties 000049f6bf436b88
Dumping properties info for ACXOBJECT 0x000049f6bf436b88

    # sets: 4

        Set: {8C134960-51AD-11CF-878A-94F801C10000}
            Id: 0, Flags: 0x1
            Id: 1, Flags: 0x1

        Set: {720D4AC0-7533-11D0-A5D6-28DB04C10000}
            Id: 0, Flags: 0x1
            Id: 1, Flags: 0x1
            Id: 2, Flags: 0x1
            Id: 3, Flags: 0x1

        Set: {C034FDB0-FF75-47C8-AA3C-EE46716B50C6}
            Id: 1, Flags: 0x1
            Id: 2, Flags: 0x1
            Id: 3, Flags: 0x1

        Set: {4D12807E-55DB-48B8-A466-F15A510F5817}
            Id: 1, Flags: 0x1

!wdfhandle

Auch in der !wdfdriverinfo Ausgabe verfügbar ist eine Verknüpfung mit einem Wdfhandle für die WDF-Objekthierarchie, die ACX zugeordnet ist.

Object Hierarchy: !wdfhandle 0x000049f6bfe9d5d8 0xff

Durch Klicken auf diesen Link wird die WDF-Objekthierarchie für den ACX-Treiber angezeigt. Diese Ausgabe kann verwendet werden, um WDF-Handles für andere ACX- und WDF-Objekte zu suchen.

0: kd> !wdfhandle 0x000049f6bfe9d5d8 0xff
Treating handle as a KMDF handle!

Dumping WDFHANDLE 0x000049f6bfe9d5d8
=============================
Handle type is WDFDRIVER
Refcount: 1
Contexts:
    context:  dt 0xffffb60940162bc0 AcxHdAudio!CODEC_DRIVER_CONTEXT (size is 0x1 bytes)
    <no associated attribute callbacks>

    context:  dt 0xffffb6093ccead20 Acx01000!AfxDriver (size is 0x20 bytes)
    EvtCleanupCallback fffff8038a455780 Acx01000!Acx::WdfCpp::ObjectContext<WDFDRIVER__ *,Acx::AfxDriver>::EvtObjectContextCleanupThunk
    EvtDestroyCallback fffff8038a455740 Acx01000!Acx::WdfCpp::ObjectContext<WDFDRIVER__ *,Acx::AfxDriver>::EvtObjectContextDestroyThunk

Child WDFHANDLEs of 0x000049f6bfe9d5d8:
    !wdfhandle 0x000049f6bfe9d5d8  dt FxDriver 0xffffb60940162a20 Context ffffb60940162bc0, Context ffffb6093ccead20 Cleanup fffff8038a455780 Destroy fffff8038a455740
        !wdfdevice 0x000049f6bffba488  dt FxDevice 0xffffb60940045b70 Context ffffb60940045e60 Cleanup fffff8038a3e3c90, Context ffffb60933f030f0 Cleanup fffff8038a451910 Destroy fffff8038a451740, Context ffffb60940a26b90, Context ffffb609409f2e00
            WDF INTERNAL   dt FxDefaultIrpHandler 0xffffb6093fa54130
            WDF INTERNAL   dt FxPkgGeneral 0xffffb609401f5610
            WDF INTERNAL   dt FxWmiIrpHandler 0xffffb609401f6510
            WDF INTERNAL   dt FxPkgIo 0xffffb6093f6d2400
                !wdfqueue 0x000049f6c00114b8  dt FxIoQueue 0xffffb6093ffeeb40
            WDF INTERNAL   dt FxPkgFdo 0xffffb6093f2ae020
            !wdfhandle 0x000049f6bfe099f8  dt FxCmResList 0xffffb609401f6600
            !wdfhandle 0x000049f6bfe0a358  dt FxCmResList 0xffffb609401f5ca0
            !wdfchildlist 0x000049f6c09adb98  dt FxChildList 0xffffb6093f652460
            !wdfiotarget 0x000049f6c092d1d8  dt FxIoTarget 0xffffb6093f6d2e20
            !wdfqueue 0x000049f6c04904c8  dt FxIoQueue 0xffffb6093fb6fb30 Context ffffb6093fa8dcd0 Cleanup fffff8038a45a350 Destroy fffff8038a45a310
            !wdfhandle 0x000049f6c09e7ed8  dt FxWorkItem 0xffffb6093f618120 Context ffffb6093f618220
            WDF INTERNAL   dt FxWmiProvider 0xffffb609403d9b50
                WDF INTERNAL   dt FxWmiInstanceExternal 0xffffb60940a11320
            WDF INTERNAL   dt FxWmiProvider 0xffffb609403d9300
                WDF INTERNAL   dt FxWmiInstanceExternal 0xffffb60940a11720
        !wdfdevice 0x000049f6bef1a848  dt FxDevice 0xffffb609410e57b0 Context ffffb609410e5aa0 Cleanup fffff8038a3e6400, Context ffffb60933f090d0 Cleanup fffff8038a451910 Destroy fffff8038a451740
            WDF INTERNAL   dt FxDefaultIrpHandler 0xffffb60940c16450
            WDF INTERNAL   dt FxPkgGeneral 0xffffb60940bc9a10
            WDF INTERNAL   dt FxWmiIrpHandler 0xffffb60940bc9380
            WDF INTERNAL   dt FxPkgIo 0xffffb609400ab5c0
                !wdfqueue 0x000049f6beefd588  dt FxIoQueue 0xffffb60941102a70
            WDF INTERNAL   dt FxPkgPdo 0xffffb609410e6020
            !wdfhandle 0x000049f6bf436e58  dt FxCmResList 0xffffb60940bc91a0
            !wdfhandle 0x000049f6bf436d68  dt FxCmResList 0xffffb60940bc9290
            !wdfqueue 0x000049f6bef185c8  dt FxIoQueue 0xffffb609410e7a30 Context ffffb60940e72ed0 Cleanup fffff8038a45a350 Destroy fffff8038a45a310
            !wdfhandle 0x000049f6bf436b88 [ACXCIRCUIT]  dt FxUserObject 0xffffb60940bc9470 Context ffffb60940bc9520, Context 
...

WDF-Protokollbefehle

!wdflogdump kann hilfreich für die Problembehandlung eines ACX-Treibers sein, indem WDF-Protokollinformationen angezeigt werden.

Zeigen Sie das Protokoll für ACX mithilfe der Option "-d-Treiber" an.

0: kd> !wdflogdump acx01000 -d 
Log dump command                           Log ID                   Size
================                           ======                   ====
 !wdflogdump  Acx01000 -a 0xFFFF820527861000  AFX_Client1              4096
 !wdflogdump  Acx01000 -a 0xFFFF8205215C0000  AFX_Log                  4096
Trace searchpath is: 

Trace format prefix is: %7!u!: %!FUNC! - 
Trying to extract TMF information from - C:\ProgramData\Dbg\sym\Acx01000.pdb\B13D39B43205B60C07935803D7CB96981\Acx01000.pdb
--- start of log ---
AFX_Client1 1: Acx::AfxCircuit::Register - INFO:ACXCIRCUIT 00007DFAD9CCCCB8 Registered
AFX_Client1 2: Acx::AfxCircuit::PowerUpNotification - INFO:ACXCIRCUIT 00007DFAD9CCCCB8, EvtAcxCircuitPowerUp callback, STATUS_SUCCESS
AFX_Client1 5: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)
AFX_Client1 7: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)
AFX_Client1 8: Acx::AfxMute::EvtMuteEventEnableCallback - INFO:ACXMUTE 00007DFADF997A18, enabled ACXEVENT 00007DFADF996F98
AFX_Client1 10: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)
AFX_Client1 12: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)
AFX_Client1 13: Acx::AfxPin::EvtJackEventEnableCallback - INFO:ACXPIN 00007DFAD4697238, enabled ACXEVENT 00007DFADF9973F8
AFX_Client1 15: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)
AFX_Client1 17: Acx::AfxPin::GetModesCount - WARN:ACXPIN 00007DFAD4697238, failed to get default format for processing mode 9e90ea20-b493-4fd1-a1a8-7e1361a956cf, 0xc0000225(STATUS_NOT_FOUND)

Verwenden Sie !wdflogdump , um das Frameworkprotokoll für einen bestimmten ACX-Treiber mithilfe der Option -f anzuzeigen.

0: kd> !wdflogdump AcxHdAudio -f
Trace searchpath is: 

Trace format prefix is: %7!u!: %4!s! %!FUNC! - 
Trying to extract TMF information from - C:\ProgramData\Dbg\sym\Wdf01000.pdb\CBDEA3A4F64C17C1752E652A91DD14761\Wdf01000.pdb
Gather log: Please wait, this may take a moment (reading 4024 bytes).
% read so far ... 10, 20, 30, 40, 50, 60, 70, 80, 90, 100
There are 65 log entries
--- start of log ---
16131: 09/03/2023-23:43:07.3233594 imp_WdfRegistryOpenKey - new WDFKEY object open failed, 0xc0000034(STATUS_OBJECT_NAME_NOT_FOUND)
16132: 09/03/2023-23:43:07.3233594 FxPowerIdleMachine::ProcessEventLocked - WDFDEVICE 0x00007DFADB0A5358 !devobj 0xFFFF820521608AF0 entering power idle state FxIdleDecrementIo from FxIdleBusy
16133: 09/03/2023-23:43:07.3233594 FxPowerIdleMachine::ProcessEventLocked - WDFDEVICE 0x00007DFADB0A5358 !devobj 0xFFFF820521608AF0 entering power idle state FxIdleStartTimer from FxIdleDecrementIo
16134: 09/03/2023-23:43:07.3233594 FxPowerIdleMachine::ProcessEventLocked - WDFDEVICE 0x00007DFADB0A5358 !devobj 0xFFFF820521608AF0 entering power idle state FxIdleTimerRunning from FxIdleStartTimer
16135: 09/03/2023-23:43:07.3233594 FxPowerIdleMachine::ProcessEventLocked - WDFDEVICE 0x00007DFADB0A5358 !devobj 0xFFFF820521608AF0 entering power idle state FxIdleCancelTimer from FxIdleTimerRunning
16136: 09/03/2023-23:43:07.3233594 FxPowerIdleMachine::ProcessEventLocked - WDFDEVICE 0x00007DFADB0A5358 !devobj 0xFFFF820521608AF0 entering power idle state FxIdleCheckIoCount from FxIdleCancelTimer
16137: 
...

Weitere Informationen

Weitere Informationen finden Sie unter Kernel Streaming Debugging. Eine exemplarische Vorgehensweise zum Debuggen mit einem WDM-Audiotreiber finden Sie unter Debug drivers – Step by Step Lab (Sysvad Kernel Mode). Weitere Informationen zu ACX finden Sie in der Übersicht über ACX-Audioklassenerweiterungen.

  • Last updated on