Sdílet prostřednictvím

Command-Line Capture Tool

  • Článek

DXCap.exe je nástroj příkazového řádku pro sběr dat diagnostiky grafiky a přehrávání.Podporuje Direct3D 10 až Direct3D 11.2 v rámci všech úrovní funkce.

DXCap.exe [-file filename] [-frame frames | -period periods | -manual] -c app [args...]
DXCap.exe -p [filename] [-debug | -warp | -hw] [-config] [-rawmode]
DXCap.exe –p [filename] –screenshot [-frame frames]
DXCap.exe –p [filename] –toXML [xml_filename]
DXCap.exe –v [–file filename] [-examine events] [-haltonfail | -exitonfail] [-showprogress]
DXCap.exe -e [search_string]
DXCap.exe -info

Parametry

  • -filefilename
    V části režim sběru dat (- c), filename Určuje název souboru protokolu grafiky, který grafické informace jsou zaznamenány do.Pokud filename není zadán, informace o grafickém budou zaznamenány do souboru s názvem < název_aplikace >-< datum >-< čas >.vsglog ve výchozím nastavení.

    V části ověření (-v) režimu filename Určuje název souboru protokolu grafickém má být ověřena.Pokud filename není zadán, protokol grafiky, který byl ověřen poslední slouží znovu.

  • -frameframes
    V části režim sběru dat frames Určuje rámce, které chcete získat.První snímek je 1.Můžete zadat více snímků pomocí čárky a rozsahy.Například pokud frames je 2, 5, 7-9, 15, pak rámců 2, 5, 7, 8, 9, a 15 zaznamenány.

  • -obdobíperiods
    V části režim sběru dat periods Určuje rozsahy čas v sekundách, během kterých chcete sbírat rámce.Pomocí čárky a rozsahů je můžete zadat více období.Například pokud periods je 2.1-5, 7.0 9.3, pak rámců, které jsou generovány mezi 2.1 a 5 sekund a mezi7 a 9.3 jsou zachyceny v sekundách.

  • -Ruční
    V části režim sběru dat – ruční Určuje, že rámce budou ručně zachyceny po stisknutí klávesy tisk obrazovky.Snímky lze zachytit, při spuštění aplikace; Nechcete-li sbírat rámce, vraťte rozhraní příkazového řádku a stiskněte klávesu enter.

  • -capp [args...]
    Zachycení režimu.V části režim sběru dat app Určuje název aplikace, které chcete zaznamenat informace o grafickém ze; args... Určuje další parametry příkazového řádku pro aplikaci.

  • -p [filename]
    Režim přehrávání (-p).V režimu přehrávání filename Určuje název souboru protokolu grafické přehrát.Pokud filename není zadán, znovu používá protokol grafiky, který byl poslední přehrávání.

  • -ladění
    V režimu přehrávání -debug určuje přehrávání by měl být prováděno s vrstvou Direct3D ladění povoleno.

  • -pokřivení
    V režimu přehrávání -pokřivení Určuje, že přehrávání se má provést pomocí vykreslovací software POKŘIVENÍ.

  • -shoduje
    V režimu přehrávání -shoduje Určuje, že přehrávání se má provést pomocí GPU hardwaru.

  • – Konfigurace
    V režimu přehrávání - config se zobrazují informace o počítači, která byla použita tak, aby zachytával souboru protokolu grafiky, pokud tyto informace byla zaznamenána do protokolu.

  • -rawmode
    V režimu přehrávání - rawmode Určuje, že přehrávání se má provést bez nutnosti úpravy zaznamenané události.Ve skupinovém rámečku běžné operace může provést režimu přehrávání malé změny přehrávání ke zjednodušení, ladění a urychlit přehrávání.Například může simulovat výstup řetězci odkládacího souboru, nikoli provádění příkazů řetězci odkládacího souboru.Obvykle to není problém, ale může být zapotřebí přehrávání neproběhne způsobem, který je více přesném na zaznamenané události; Například můžete tuto možnost k obnovení celé obrazovky vykreslením aplikace, která byla zachycena při spouštění v režimu celé obrazovky.

  • -toXML [xml_filename]
    V režimu přehrávání xml_filename Určuje název souboru, s níž je zapsána XML reprezentaci přehrávání.Pokud xml_filename není zadán, reprezentaci XML je zapsán do souboru s názvem stejná jako soubor během přehrávání, ale zadaný .xml rozšíření.

  • -v
    Režim ověření.V části ověření režim rámců se přehrávají zpět na hardware a POKŘIVENÍ a jejich výsledky se pak porovnávají funkcí porovnání obrázku.Tato funkce slouží rychle identifikovat problémy ovladačů, které mají vliv na vaše vykreslování.

  • -Zkontrolujteevents
    V režimu ověření events Určuje sadu událostí grafické okamžité, jejichž výsledky se pak porovnávají.Můžete například -Zkontrolujte přítomen, kreslit, kopírovat, vymazat omezuje porovnání se pouze události, které patří do těchto kategorií.

    Tip

    Doporučujeme, abyste počínaje -Zkontrolujte přítomen, kreslit, kopírovat, vymazat vzhledem k tomu, že to bude odkrýt většinu problémů však trvat výrazně kratší dobu než rozsáhlejší sadu událostí.V případě potřeby můžete určit větší nebo jinou sadu událostí můžete ověřit tyto události a odkrýt jiné druhy problémy.

  • -haltonfail
    V režimu ověření - haltonfail zastaví ověření, jestliže jsou zjištěna rozdíly mezi hardwarem a nástroj pro vykreslování POKŘIVENÍ.Ověření obnoví po stisknutí klávesy.

  • -exitonfail
    V režimu ověření - exitonfail ukončí ověření okamžitě při zjištění rozdíly mezi hardwarem a nástroj pro vykreslování POKŘIVENÍ.Program ukončí tímto způsobem, vrátí 0 do prostředí, v opačném případě vrátí 1.

  • -showprogress
    V režimu ověření - showprogress zobrazuje informace o průběhu o relaci pro ověření.Průběh POKŘIVENÍ se zobrazí na levé straně; průběh hardwaru se zobrazí v pravé části.

  • -esearch_string
    Vytvoří výčet aplikací pro Windows Store, které jsou nainstalovány.Tyto informace slouží k provádění příkazového řádku zachycení s aplikací pro Windows Store.

  • -informace
    Zobrazuje informace o knihovny DLL zachytávání a počítače.

Poznámky

DXCap.exe pracuje ve třech režimech:

  • Zachycení režimu (-c)
    Získávání informací o grafickém z spuštěné aplikace a zaznamenat je do souboru protokolu grafiky.Sběr dat možnosti a formát souboru jsou shodné s hodnotami sady Visual Studio.

  • Režim přehrávání (-p)
    Přehrát dříve zachycené grafické událostí z existujícího souboru protokolu grafiky.Ve výchozím nastavení v okně, dojde k přehrávání i v případě, že grafika protokolu souboru byla zachycena z celé obrazovky aplikace.Přehrávání dojde v celoobrazovkovém pouze po přihlášení grafiky souboru byla zachycena z celé obrazovky aplikace a – rawmode je zadán.

  • Režim ověření (- v)
    Ověří vykreslením přehrávání rámců na hardware a POKŘIVENÍ a poté porovnání jejich výsledků funkcí porovnání obrázku.Tato funkce slouží rychle identifikovat problémy ovladačů, které mají vliv na vaše vykreslování.

Kromě těchto režimů provede dxcap.exe dvě další funkce, které neprovádějte výstřižek nebo přehrávání grafické informace.

  • Funkce výčtu (-e)
    Zobrazí podrobnosti o aplikací pro Windows Store, které jsou nainstalovány v počítači.Tyto informace zahrnují ID aplikace, které identifikují spustitelný soubor v aplikaci pro Windows Store a názvu balíčku.K získání informací o grafickém z aplikace pro windows store pomocí DXCap.exe, použijte namísto spustitelného souboru, který se používá při zachycení aplikace pro klasickou plochu appid a názvu balíčku.

  • Informace o funkci (– informace o)
    Zobrazí podrobnosti o knihovny DLL zachytávání a počítače.

Příklady

Získávání informací o grafickém z aplikace pro klasickou plochu

Použití – c k určení aplikace, ze kterého chcete získat informace o grafickém.

DXCap.exe –c BasicHLSL11.exe

Ve výchozím nastavení, informace o grafickém budou zaznamenány do souboru s názvem < název_aplikace >-< datum >-< čas >.vsglog.Použití – soubor k určení k zaznamenání na jiný soubor.

DXCap.exe –file regression_test_12.vsglog –c BasicHLSL11.exe

Zadejte další parametry příkazového řádku pro aplikaci, kterou budete zpracovat z zahrnutím po názvu souboru do aplikace.

DXCap.exe –c "C:\Program Files\Internet Explorer\iexplorer.exe" "www.fishgl.com"

Příkaz v předchozím příkladu jsou zaznamenány grafické informace z plochy verze aplikace Internet Explorer při prohlížení webové stránky v umístění www.fishgl.com využívající rozhraní API WebGL k vykreslení 3D obsahu.

[!POZNÁMKA]

Vzhledem k tomu, že na něj jsou předávány argumenty příkazového řádku, které se zobrazí po aplikaci, je třeba zadat argumenty určené pro DXCap.exe před použitím – c možnost.

Získávání informací o grafickém z aplikace pro Windows Store.

Můžete zaznamenávat grafické informace z aplikace pro Windows Store.

DXCap.exe –c Microsof.BingMaps_2.1.2914.1734_x64__8wekyb3d8bbwe,AppexMaps

Pomocí DXCap.exe tak, aby zachytával z aplikace pro Windows Store se podobá jeho používání tak, aby zachytával z aplikace pro klasickou plochu Windows, ale místo toho identifikující aplikace pro klasickou plochu podle názvu souboru, identifikovat aplikace pro Windows Store tak, že jeho název balíčku a název nebo ID spustitelný uvnitř tento balíček, který jste chcete zachytit z.Chcete-li vám usnadní zjistit, jak k identifikaci aplikace pro Windows Store, které jsou nainstalovány v počítači, použijte – e možnost s DXCap.exe vyčíslit je:

DXCap.exe -e

Můžete nabídnout řetězec volitelné vyhledávání vám pomohou najít aplikaci, kterou hledáte.Je-li hledaný řetězec, vytvoří výčet DXCap.exe aplikace pro Windows Store jejichž název balíčku, názvu aplikace nebo ID aplikace, která odpovídají hledanému řetězci.Hledání nerozlišuje malá a velká písmena.

DXCap.exe –e map

Příkaz výše uvedené podává výčet aplikací pro Windows Store, které odpovídají "map"; Zde je výstup:

Poslední řádek výstupu pro každou aplikaci ve výčtu zobrazí příkaz, který můžete použít k získání informací o grafickém z něj.

Sbírat určité snímky nebo snímky mezi určitou dobu.

Použití – snímek k určení rámců, které chcete zachytit pomocí čárky a rozsahy:

DXCap.exe –frame 2,5,7-9,15 –c SimpleBezier11.exe

Nebo použijte – období k určení sadu časový rozsah během pro zachytávání rámců.Čas rozsahy jsou zadány v sekundách, a lze zadat více rozsahů:

DXCap.exe –period 2.1-5, 7.0-9.3 –c SimpleBezier11.exe

Interaktivně sbírat rámce.

Použití – ruční zachytávání rámců interaktivně.Stiskněte klávesu Enter, chcete-li spustit sběr dat a stiskněte klávesu Enter akci ukončíte.

DXCap.exe –manual -c SimpleBezier11.exe

Přehrát grafického souboru protokolu

Použití -p k přehrání dříve zachycené grafického souboru protokolu.

DXCap.exe –p regression_test_12.vsglog

Nechte si název souboru k přehrání grafické protokolu, který naposledy byla zachycena.

DXCap.exe –p

Přehrát v režimu bez předzpracování

Použití - rawmode k přehrání zachycené příkazy přesně tak, jak k nim došlo.Ve skupinovém rámečku Normální přehrávání jsou Emulovaný určité příkazy, například soubor protokolu grafické zachyceny z celé obrazovky aplikace budou přehrávat v okně; s povoleným režimem nezpracovanou stejný soubor se pokusí přehrát na celé obrazovce.

DXCap.exe –p regression_test_12.vsglog -rawmode

Přehrát zpět pomocí POKŘIVENÍ nebo hardwarového zařízení

Chcete vynutit přehrát zadní soubor protokolu grafické zachyceny v hardwarové zařízení, které chcete použít POKŘIVENÍ, nebo vynuťte přehrávání do protokolu zaznamenána na POKŘIVENÍ používat hardwarovým zařízením.Použití -pokřivení k přehrání zpět použití POKŘIVENÍ.

DXCap.exe –p regression_test_12.vsglog -warp

Použití -shoduje k přehrání zpět pomocí hardwaru.

DXCap.exe –p regression_test_12.vsglog -hw

Ověření souboru protokolu grafické proti POKŘIVENÍ

V části režim ověřování v souboru protokolu grafické přehrávání na hardware a POKŘIVENÍ a jejich výsledky jsou porovnávány.To může pomoci identifikovat chyby vykreslování, které jsou způsobeny ovladač.– V slouží k ověření správné chování grafický hardware proti POKŘIVENÍ.

DXCap.exe -v regression_test_12.vsglog

Chcete-li snížit objem porovnání, můžete určit podmnožinu příkazů pro ověření k porovnání a další příkazy budou ignorovány.Používat – zkontrolujte příkazy, jejichž výsledky chcete porovnat určíte.

DXCap.exe -v regression_test_12.vsglog –examine present,draw,copy,clear

Převést soubor protokolu grafiky PNG

Chcete-li zobrazit nebo analyzovat snímky ze souboru protokolu grafiky, DXCap.exe lze uložit rámců PNG soubory obrázků (přenosných Network Graphics).Použití – snímek obrazovky do zachycena v režimu přehrávání do výstupního rámce jako soubory PNG.

DXCap.exe -p BasicHLSL11.vsglog -screenshot

Použití – snímek s – snímek obrazovky k určení rámců, které chcete uložit výstupní.

DXCap.exe -p BasicHLSL11.vsglog -screenshot –frame 5, 7-9

Převést soubor protokolu grafické XML.

Ke zpracování a analýzu protokolů grafiky pomocí známých nástrojů, jako jsou například FindStr nebo XSLT, DXCap.exe soubor protokolu grafické převést do formátu XML.Použití - toXML v režimu přehrávání převést do protokolu XML namísto přehrání jej zpět.

DXCap.exe –p regression_test_12.vsglog –toXML

Ve výchozím výstupu XML je zapsán do souboru se stejným názvem, jako v grafickém protokolu, ale které byla poskytnuta příponu XML.V předchozím příkladu bude soubor XML nazvaný regression_test_12.xml.Zadejte jiný název souboru XML, zadejte ji po - toXML.

DXCap.exe –p regression_test_12.vsglog –toXML temp.xml

Výsledný soubor bude obsahovat XML, které vypadá podobně jako následující:

<Moment value="67"/>
<Method name="CreateDXGIFactory1" >
    <Return type="HRESULT" value="S_OK" />
    <Parameter name="riid" type="IID" value="770AAE78-F26F-4DBA-A829-253C83D1B387" />
    <Parameter name="ppFactory" type="void" handle="1" isOutput="true" />
</Method>

<Moment value="167"/>
<Method name="D3D11CreateDevice" >
    <Return type="HRESULT" value="S_OK" />
    <Parameter name="pAdapter" type="IDXGIAdapter" handle="34" />
    <Parameter name="DriverType" type="D3D_DRIVER_TYPE" value="D3D_DRIVER_TYPE_UNKNOWN" />
    <Parameter name="Software" type="HMODULE" value="pointer" />
    <Parameter name="Flags" type="UINT" value="0" />
    <Parameter name="pFeatureLevels" type="D3D_FEATURE_LEVEL" arrSize="1" >
        <Element value="D3D_FEATURE_LEVEL_11_0" />
    </Parameter>
    <Parameter name="FeatureLevels" type="UINT" value="1" />
    <Parameter name="SDKVersion" type="UINT" value="7" />
    <Parameter name="ppDevice" type="ID3D11Device" handle="35" isOutput="true" />
    <Parameter name="pFeatureLevel" type="D3D_FEATURE_LEVEL" value="D3D_FEATURE_LEVEL_11_0" isOutput="true" />
    <Parameter name="ppImmediateContext" type="ID3D11DeviceContext" value="nullptr" isOutput="true" />
</Method>