Udostępnij za pośrednictwem

Command-Line Capture Tool

  • Artykuł

DXCap.exe to narzędzie wiersza polecenia dla grafiki diagnostyki przechwytywanie i odtwarzanie.Obsługuje on 10 Direct3D za pośrednictwem Direct3D 11.2 we wszystkie poziomy funkcji.

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
    W trybie przechwytywania (- c), filename Określa nazwę pliku dziennika grafiki, który grafiki informacje są zapisywane do.Jeśli filename nie jest określony, grafiki informacje są zapisywane w pliku o nazwie < nazwa aplikacji >-< data >-< godzina >.vsglog domyślnie.

    W obszarze weryfikacji (-v) trybie filename Określa nazwę pliku dziennika grafiki, który ma zostać zweryfikowana.Jeśli filename nie zostanie określona, w dzienniku grafiki, który został zweryfikowany ostatniej jest używane ponownie.

  • -frameframes
    W trybie przechwytywania frames Określa ramek, które mają być przechwytywane.Pierwsza ramka jest 1.Można określić wiele ramek za pomocą przecinków i zakresów.Na przykład jeśli frames jest 2, 5, 7-9, 15, następnie ramki 2, 5, 7, 8, 9, i 15 są przechwytywane.

  • -okresperiods
    W trybie przechwytywania periods Określa zakres czasu, w sekundach, w których mają być przechwytywane ramki.Można określić wiele okresów przy użyciu przecinków i zakresów.Na przykład jeśli periods jest 2.1-5, 7.0 9.3, a następnie ramki, które są renderowane między 2.1 i 5 w sekundach i między7 i 9.3 są przechwytywane w sekundach.

  • — Ręczne
    W trybie przechwytywania -Ręczne Określa, że ramki zostanie przechwycona ręcznie po naciśnięciu klawisza ekranu drukowania.Ramki może zostać przechwycone podczas uruchamiania aplikacji; Aby zatrzymać przechwytywanie ramek, wróć do interfejsu wiersza polecenia, a następnie naciśnij klawisz enter.

  • -capp [args...]
    Przechwytywanie trybu.W trybie przechwytywania app Określa nazwę aplikacji, która mają być przechwytywane grafiki informacji z; args... Określa dodatkowych parametrów wiersza polecenia do tej aplikacji.

  • -p [filename]
    Tryb odtwarzania (-p).W trybie odtwarzania filename Określa nazwę pliku można odtwarzać grafiki.Jeśli filename nie zostanie określona, w dzienniku grafiki, który został ostatnio odtwarzane jest używane ponownie.

  • -debugowanie
    W trybie odtwarzania -debug określa tego odtwarzanie powinien być wykonany z warstwą debugowania Direct3D włączone.

  • -zawijania
    W trybie odtwarzania -zawijania określa tego odtwarzanie należy wykonać przy użyciu renderowanie programowe ZAWIJANIA.

  • -sprzętu
    W trybie odtwarzania -sprzętowego określa tego odtwarzanie należy wykonać przy użyciu GPU sprzętu.

  • -config
    W trybie odtwarzania - config Wyświetla informacje o komputerze użytą do przechwytywania grafiki pliku dziennika, jeśli te informacje został zarejestrowany w dzienniku.

  • -rawmode
    W trybie odtwarzania - rawmode określa tego odtwarzanie powinien być wykonany bez modyfikacji zarejestrowane zdarzenia.W normalnych warunkach tryb odtwarzania może wprowadzać zmiany pośredniej odtwarzanie, aby uprościć debugowania i przyspieszyć odtwarzanie.Na przykład mogą symulować wymiany łańcuch wyjściowy niż wykonywania poleceń łańcuch wymiany.Zazwyczaj nie jest to problem, ale może być konieczne odtwarzanie w sposób niezgodny z bardziej dobrej wierze zarejestrowanych zdarzeń; Można na przykład, użyj tej opcji, aby przywrócić zachowanie pełnoekranowym renderowaniem do przechwycenia podczas pracy w trybie pełnoekranowym aplikacji.

  • -toXML [xml_filename]
    W trybie odtwarzania xml_filename Określa nazwę pliku, w którym zapisywana jest reprezentację XML odtwarzania.Jeśli xml_filename nie jest określony, reprezentację XML jest zapisywana w pliku o nazwie taki sam jak plik jest odtwarzany, ale podane .xml rozszerzenia.

  • -v
    Tryb sprawdzania poprawności.W trybie weryfikacji przechwycone ramki są odtwarzane w sprzętowe i ZAWIJANIA, a ich wyniki są porównywane przy użyciu funkcji porównanie obrazu.Ta funkcja umożliwia szybką identyfikację sterownik problemy, które wpływa na Twój renderowania.

  • -należy sprawdzić, czyevents
    W trybie weryfikacji events Określa zestaw zdarzeń grafiki, którego wyniki natychmiastowe są porównywane.Na przykład -należy sprawdzić, czy występuje, rysowania, kopiować, usuń zaznaczenie ogranicza porównania do zdarzeń należące do tych kategorii.

    PoradaPorada

    Firma Microsoft zaleca, rozpoczynając od -należy sprawdzić, czy występuje, rysowania, kopiować, usuń zaznaczenie ponieważ spowoduje to ujawnić większość problemów, ale trwać znacznie krócej niż szerszy zestaw zdarzeń.W razie potrzeby można określić większy lub inny zestaw zdarzenia w celu zweryfikowania te zdarzenia i poznać inne rodzaje problemów.

  • -haltonfail
    W trybie weryfikacji - haltonfail zatrzymuje weryfikacji po wykryciu różnic między sprzętu i ZAWIJANIA renderowania.Sprawdzanie poprawności wznawia po naciśnięciu klawisza.

  • -exitonfail
    W trybie weryfikacji - exitonfail zakończenia sprawdzania poprawności natychmiast po wykryto różnic między sprzętu i ZAWIJANIA renderowania.Gdy program kończy pracę w ten sposób, zwraca 0 w środowisku, w przeciwnym razie zwraca 1.

  • -showprogress
    W trybie weryfikacji - showprogress Wyświetla informacje o postępie o sesji weryfikacji.Postęp ZAWIJANIA jest wyświetlany po lewej stronie; postęp sprzętu jest wyświetlany po prawej stronie.

  • -esearch_string
    Wylicza aplikacje do Sklepu Windows, które są zainstalowane.Te informacje można użyć do wykonywania wiersza polecenia przechwytywane aplikacji ze Sklepu Windows.

  • — informacje
    Wyświetla informacje dotyczące komputera i przechwytywania biblioteki dll.

Uwagi

DXCap.exe działa w trzech trybach:

  • Przechwytywanie tryb (-c)
    Przechwytywanie informacji grafiki z uruchomionych aplikacji i zarejestrować go w pliku dziennika grafiki.Możliwości przechwytywania i format pliku są identyczne z programu Visual Studio.

  • Tryb odtwarzania (-p)
    Odtwarzanie grafiki wcześniej przechwycone zdarzenia z istniejącego pliku dziennika grafiki.Domyślnie odtwarzanie występuje w oknie, nawet w przypadku logowania grafiki pliku przechwycenia z pełnoekranowego aplikacji.Odtwarzanie występuje w trybie pełnoekranowym tylko podczas logowania grafiki z aplikacji pełnoekranowego przechwycenia pliku i rawmode — jest określony.

  • Tryb walidacji (- v)
    Weryfikuje zachowanie renderowania odtwarzanie przechwycone ramki na sprzętowe i ZAWIJANIA, a następnie porównywanie osiągnęli za pomocą funkcji porównanie obrazu.Ta funkcja umożliwia szybką identyfikację sterownik problemy, które wpływa na Twój renderowania.

Oprócz tych trybów dxcap.exe wykonuje dwie funkcje, które nie wykonuj przechwytywanie i odtwarzanie informacji grafiki.

  • Funkcja wyliczenia (-e)
    Wyświetla szczegółowe informacje dotyczące aplikacji Sklepu Windows, które są zainstalowane na komputerze.Informacje te obejmują nazwę pakietu i identyfikator aplikacji, które identyfikować plik wykonywalny w aplikacji ze Sklepu Windows.Do przechwytywania informacji grafiki z aplikacji ze sklepu windows za pomocą DXCap.exe, zamiast nazwy pliku wykonywalnego, używanego podczas przechwytywania aplikacji komputerowej przy użyciu nazwy pakietu i identyfikator aplikacji.

  • Informacje o funkcji (— informacje)
    Wyświetla szczegółowe informacje dotyczące komputera i przechwytywania biblioteki dll.

Przykłady

Przechwytywanie informacji grafiki z aplikacji komputerowej

Użyj — c do określenia aplikacji, z którego mają być przechwytywane informacji grafiki.

DXCap.exe –c BasicHLSL11.exe

Domyślnie grafiki informacje są zapisywane w pliku o nazwie < nazwa aplikacji >-< data >-< godzina >.vsglog.Użyj — pliku do określania do rejestrowania do innego pliku.

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

Określić dodatkowe parametry wiersza polecenia do aplikacji, która jest przechwytywanie z, umieszczając je po filename wybranej aplikacji.

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

Polecenie w powyższym przykładzie zawiera informacje dotyczące grafiki z tej wersji programu Internet Explorer podczas wyświetlania strony sieci Web, który znajduje się w www.fishgl.com do renderowania zawartości trójwymiarowe który używa interfejsu API WebGL.

[!UWAGA]

Ponieważ argumenty wiersza polecenia, które są widoczne po aplikacji są przekazywane do niej, należy określić argumenty przeznaczonych do DXCap.exe przed użyciem — c opcji.

Przechwytywanie informacji grafiki z aplikacji ze Sklepu Windows.

Możesz przechwytywać grafiki informacji z aplikacji ze Sklepu Windows.

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

Przechwytywanie z aplikacji ze Sklepu Windows za pomocą DXCap.exe jest podobny do niej do przechwytywania z aplikacji pulpitu systemu Windows, ale zamiast tego zidentyfikowania aplikacji komputerowej nazwy, zidentyfikować aplikacji ze Sklepu Windows przy jego nazwa pakietu i lub identyfikator pliku wykonywalnego wewnątrz, że pakiet, które ma być przechwytywanie z.Aby ułatwić Dowiedz się, jak zidentyfikować aplikacje do Sklepu Windows, które są zainstalowane na komputerze, należy użyć — e opcji z DXCap.exe wyliczyć ich:

DXCap.exe -e

Można podać ciąg opcjonalny wyszukiwania do znajdowania aplikacji, którego szukasz.Jeśli ciąg wyszukiwania zostanie podana, DXCap.exe wylicza aplikacje Sklepu Windows, którego nazwa pakietu, nazwy aplikacji lub identyfikatorów aplikacji zgodny z ciągiem wyszukiwania.Wyszukiwanie jest uwzględniana wielkość liter.

DXCap.exe –e map

Powyższe polecenie wylicza aplikacji ze Sklepu Windows zgodnych "mapy"; Oto dane wyjściowe:

Ostatni wiersz danych wyjściowych dla każdej aplikacji wyliczany zawiera polecenia, które umożliwia przechwytywanie informacji grafiki z niej.

Przechwytywanie określonych klatek lub klatek między określonych terminach.

Użyj — ramki do określenia ramki, które mają zostać przechwycone za pomocą przecinków i zakresów:

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

Lub użyj — okres do określenia zestawu zakresów czasu, podczas których do przechwytywania ramek.Określono zakresów czasu w sekundach i można określić wiele zakresów:

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

Przechwytywać ramki w trybie interakcyjnym.

Użyj — Ręczne do przechwytywania ramek w trybie interakcyjnym.Naciśnij klawisz Enter, aby rozpocząć przechwytywanie, a następnie naciśnij klawisz Enter, aby zatrzymać.

DXCap.exe –manual -c SimpleBezier11.exe

Odtworzyć plik dziennika grafiki

Użyj -p Aby odtworzyć wcześniej przechwycone plik dziennika.

DXCap.exe –p regression_test_12.vsglog

Wykluczenia nazwy pliku, aby odtworzyć przechwycenia ostatnio dziennik grafiki.

DXCap.exe –p

Są odtwarzane w trybie raw

Użyj - rawmode Aby odtworzyć przechwycone polecenia dokładnie tak, jak ich wystąpienia.W obszarze normalne odtwarzanie odtworzone są pewne polecenia, na przykład plik dziennika grafiki przechwycona z aplikacji w trybie pełnoekranowym zostaną odtworzone w oknie; nieprzetworzona włączono obsługę trybu ten sam plik podejmie próbę są odtwarzane w trybie pełnoekranowym.

DXCap.exe –p regression_test_12.vsglog -rawmode

Odtwarzanie przy użyciu ZAWIJANIA lub urządzenie sprzętowe

Istnieje możliwość, że należy wymuszać odtwarzania tyłu plik dziennika grafiki przechwycone na urządzenie sprzętowe do używania ZAWIJANIA lub wymusić odtwarzanie dziennika przechwyconych ZAWIJANIA do użycia z urządzeniem sprzętowym.Użyj -zawijania ma być odtworzony przy użyciu ZAWIJANIA.

DXCap.exe –p regression_test_12.vsglog -warp

Użyj -sprzętowego ma być odtworzony przy użyciu sprzętu.

DXCap.exe –p regression_test_12.vsglog -hw

Sprawdź poprawność pliku dziennika grafika przeciw ZAWIJANIA

W trybie weryfikacji pliku dziennika grafiki odtwarzania na sprzętowe i ZAWIJANIA, a ich wyniki są porównywane.Ułatwia to znalezienie renderowania błędów, które są wywoływane przez sterownik.Umożliwia sprawdzanie poprawności poprawne zachowanie sprzętu grafika przeciw ZAWIJANIA — v.

DXCap.exe -v regression_test_12.vsglog

Aby zmniejszyć ilość porównania, można określić podzbiór poleceń do weryfikacji do porównania i inne polecenia zostaną zignorowane.Użyj — należy sprawdzić, czy można określać polecenia, którego wyniki mają do porównania.

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

Konwertowanie pliku dziennika grafiki PNG

Aby wyświetlić lub analizy ramki z pliku dziennika grafiki, DXCap.exe można zapisać przechwycone ramki jako .png pliki obrazów (Portable Network Graphics).Użyj — Zrzut ekranu aby w trybie odtwarzania, aby produkt wyjściowy przechwycone ramki jako pliki PNG.

DXCap.exe -p BasicHLSL11.vsglog -screenshot

Użyj — ramki z — Zrzut ekranu do określenia ramki, które mają zostać danych wyjściowych.

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

Konwertuj plik dziennika grafiki do formatu XML

Przetwarzanie i analizowanie dzienniki grafiki przy użyciu znanych narzędzi, takich jak FindStr i XSLT, DXCap.exe można przekonwertować plik dziennika grafiki do formatu XML.Użyj - toXML w trybie odtwarzania można przekonwertować dziennika do pliku XML, a nie utworzyć kopię.

DXCap.exe –p regression_test_12.vsglog –toXML

Domyślnie dane wyjściowe XML jest zapisywana do pliku o takiej samej nazwie logowania grafiki, ale które podano rozszerzenie .xml.W przypadku powyższego przykładu będzie nazwę pliku XML regression_test_12.xml.Podaj inną nazwę pliku XML, ustaw je po - toXML.

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

Wynikowy plik będzie zawierał XML, która wygląda podobnie do następującej:

<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>