Condividi tramite

Strumento di acquisizione da riga di comando

  • Articolo

DXCap.exe è uno strumento da riga di comando per l'acquisizione e la riproduzione della diagnostica grafica. Supporta Direct3D dalla versione 10 alla 11.2 per tutti i livelli di funzionalità.

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

Parametri

  • -filefilename
    In modalità di acquisizione (-c), filename specifica il nome del file di log di grafica in cui vengono registrate le informazioni grafiche. Se filename non viene specificato, per impostazioni predefinita le informazioni grafiche vengono registrate in un file denominato <nomeapp>-<data>-<ora>.vsglog

    In modalità di convalida (-v), filename specifica il nome del file di log di grafica da convalidare. Se filename non viene specificato, viene usato di nuovo il log di grafica dell'ultima convalida.

  • -frameframes
    In modalità di acquisizione, frames specifica i frame da acquisire. Il primo frame è 1. È possibile specificare più frame usando virgole e intervalli. Ad esempio, se frames è 2, 5, 7-9, 15, verranno acquisiti i frame 2, 5, 7, 8, 9 e 15.

  • -periodperiods
    In modalità di acquisizione, periods specifica gli intervalli di tempo, espressi in secondi, durante i quali acquisire i frame. È possibile specificare più periodi usando virgole e intervalli. Ad esempio, se periods è 2.1-5, 7.0-9.3, verranno acquisiti i frame di cui è stato eseguito il rendering tra 2,1 e 5 secondi e tra 7 e 9,3 secondi.

  • -manual
    In modalità di acquisizione, -manual specifica che i frame verranno acquisiti manualmente premendo il tasto STAMP. È possibile acquisire i frame all'avvio dell'app. Per interrompere l'acquisizione dei frame, tornare all'interfaccia della riga di comando e premere INVIO.

  • -capp [args...]
    Modalità di acquisizione. In modalità di acquisizione, app specifica il nome dell'app da cui acquisire le informazioni grafiche; args... specifica ulteriori parametri della riga di comando per tale app.

  • -p [filename]
    Modalità di riproduzione (-p). In modalità di riproduzione, filename specifica il nome del file di log di grafica da riprodurre. Se filename non viene specificato, viene usato di nuovo il log di grafica dell'ultima riproduzione.

  • -debug
    In modalità di riproduzione, -debug specifica che la riproduzione deve essere eseguita con il livello di debug Direct3D abilitato.

  • -warp
    In modalità di riproduzione, -warp specifica che la riproduzione deve essere eseguita mediante il programma di rendering software WARP.

  • -hw
    In modalità di riproduzione, -hw specifica che la riproduzione deve essere eseguita mediante l'hardware della GPU.

  • -config
    In modalità di riproduzione, -config visualizza le informazioni sul computer usato per acquisire il file di log di grafica, se tali informazioni sono state registrate nel log.

  • -rawmode
    In modalità di riproduzione, -rawmode specifica che la riproduzione deve essere eseguita senza modificare gli eventi registrati. Durante il normale funzionamento, la modalità di riproduzione potrebbe apportare piccole modifiche alla riproduzione per semplificare il debug e velocizzare la riproduzione. Ad esempio, potrebbe simulare l'output della catena di scambio, anziché l'esecuzione dei comandi della catena di scambio. In genere questo non è un problema, ma potrebbe essere necessario che la riproduzione avvenga in modo più fedele agli eventi registrati. È possibile ad esempio usare questa opzione per ripristinare il comportamento di rendering a schermo intero in un'app acquisita durante l'esecuzione in modalità a schermo intero.

  • -toXML [xml_filename]
    In modalità di riproduzione, xml_filename specifica il nome del file in cui viene scritta una rappresentazione XML della riproduzione. Se xml_filename non viene specificato, la rappresentazione XML viene scritta in un file denominato come il file da riprodurre, ma con l'estensione .xml.

  • -v
    Modalità di convalida. In modalità di convalida, i frame acquisiti vengono riprodotti sia su dispositivi hardware che WARP e i relativi risultati vengono confrontati mediante una funzione di confronto immagini. È possibile usare questa funzionalità per identificare rapidamente i problemi di driver che interessano il rendering.

  • -examineevents
    In modalità di convalida, events specifica il set di eventi grafici di cui vengono confrontati i risultati immediati. Ad esempio, -examine present,draw,copy,clear limita il confronto solo agli eventi appartenenti a tali categorie.

    Suggerimento

    È consigliabile iniziare con -examine present,draw,copy,clear perché verranno rivelati la maggior parte dei problemi impiegando però molto meno tempo di un set più completo di eventi.Se necessario, è possibile specificare un set di eventi diverso o più grande per convalidare tali eventi e rivelare altri tipi di problemi.

  • -haltonfail
    In modalità di convalida, -haltonfail interrompe la convalida quando vengono rilevate differenze tra il renderer hardware e WARP. Per riprendere la convalida, premere un tasto.

  • -exitonfail
    In modalità di convalida, -exitonfail esce immediatamente dalla convalida quando vengono rilevate differenze tra il renderer hardware e WARP. Quando il programma si chiude in questo modo, viene restituito 0 per l'ambiente; in caso contrario, viene restituito 1.

  • -showprogress
    In modalità di convalida, -showprogress visualizza le informazioni sullo stato relative alla sessione di convalida. Lo stato WARP viene visualizzato a sinistra; lo stato hardware viene visualizzato a destra.

  • -esearch_string
    Enumera le app di Windows Store installate. È possibile usare queste informazioni per eseguire le acquisizioni dalla riga di comando con le app di Windows Store.

  • -info
    Visualizza le informazioni sul computer e sulle DLL di acquisizione.

Note

DXCap.exe funziona in tre modalità:

  • Modalità di acquisizione (-c)
    Consente di acquisire le informazioni grafiche da un'app in esecuzione e le registra in un file di log di grafica. Le funzionalità di acquisizione e il formato di file sono identici a quelli di Visual Studio.

  • Modalità di riproduzione (-p)
    Consente di riprodurre gli eventi grafici acquisiti in precedenza da un file di log di grafica esistente. Per impostazione predefinita, la riproduzione avviene in una finestra, anche quando il file di log di grafica è stato acquisito da un'app a schermo intero. La riproduzione viene eseguita a schermo intero solo quando il file di log di grafica è stato acquisito da un'app a schermo intero e viene specificato –rawmode.

  • Modalità di convalida (-v)
    Convalida il comportamento di rendering riproducendo i frame acquisiti, sia su dispositivi hardware che WARP, quindi confrontando i risultati con una funzione di confronto immagini. È possibile usare questa funzionalità per identificare rapidamente i problemi di driver che interessano il rendering.

Oltre a queste modalità, dxcap.exe esegue altre due funzioni che non eseguono l'acquisizione o la riproduzione di informazioni grafiche.

  • Funzione di enumerazione (-e)
    Visualizza i dettagli relativi alle app di Windows Store installate nel computer. Questi dettagli includono il nome del pacchetto e l'ID app che identificano il file eseguibile in un'app di Windows Store. Per acquisire informazioni grafiche da un'app di Windows Store con DXCap.exe, usare il nome del pacchetto e l'ID app anziché il nome del file eseguibile usato durante l'acquisizione di un'app desktop.

  • Funzione informazioni (-info)
    Visualizza i dettagli sul computer e sulle DLL di acquisizione.

Esempi

Acquisizione di informazioni grafiche da un'app desktop

Usare –c per specificare l'app da cui acquisire le informazioni grafiche.

DXCap.exe –c BasicHLSL11.exe

Per impostazione predefinita, le informazioni grafiche vengono registrate in un file denominato <nomeapp>-<data>-<ora>.vsglog. Usare –file per specificare un file diverso in cui registrare.

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

Specificare ulteriori parametri della riga di comando per l'app da cui si esegue l'acquisizione includendoli dopo il nome file dell'app.

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

Il comando dell'esempio precedente acquisisce informazioni grafiche della versione desktop di Internet Explorer durante la visualizzazione della pagina Web all'indirizzo www.fishgl.com che usa l'API WebGL per il rendering del contenuto in 3D.

Nota

Poiché gli argomenti della riga di comando inseriti dopo l'app vengono passati all'app, è necessario specificare gli argomenti per DXCap.exe prima di usare l'opzione –c.

Acquisizione di informazioni grafiche da un'app di Windows Store

È possibile acquisire informazioni grafiche da un'app di Windows Store.

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

L'uso di DXCap.exe per l'acquisizione da un'app di Windows Store è simile a quello per l'acquisizione da un'app desktop di Windows, ma anziché identificare l'app desktop con il nome del file, l'app di Windows Store viene identificata con il nome del pacchetto e il nome o l'ID dell'eseguibile contenuto nel pacchetto da cui eseguire l'acquisizione. Per semplificare l'identificazione delle app di Windows Store installate nel computer, usare l'opzione –e con DXCap.exe per enumerarle:

DXCap.exe -e

È possibile fornire una stringa di ricerca facoltativa per trovare l'app che si sta cercando. Quando viene fornita la stringa di ricerca, DXCap.exe enumera le app di Windows Store con il nome del pacchetto, il nome dell'app o gli ID app corrispondenti alla stringa di ricerca. La ricerca non fa distinzione tra maiuscole e minuscole.

DXCap.exe –e map

Il comando precedente enumera le app di Windows Store che corrispondono a "map". Di seguito è riportato l'output:

L'ultima riga di output per ogni app enumerata visualizza il comando che è possibile usare per acquisire informazioni grafiche dall'app stessa.

Acquisizione di frame specifici o frame tra intervalli di tempo specifici

Usare –frame per specificare i frame da acquisire con virgole e intervalli:

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

In alternativa, usare –period per specificare un set di intervalli di tempo durante i quali acquisire i frame. Gli intervalli di tempo vengono specificati in secondi ed è possibile indicare più intervalli:

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

Acquisizione di frame in modo interattivo

Usare –manual per acquisire i frame in modo interattivo. Premere INVIO per avviare l'acquisizione e premere di nuovo INVIO per interromperla.

DXCap.exe –manual -c SimpleBezier11.exe

Riproduzione di un file di log di grafica

Usare -p per riprodurre un file di log di grafica acquisito in precedenza.

DXCap.exe –p regression_test_12.vsglog

Omettere il nome del file per riprodurre il log di grafica acquisito più di recente.

DXCap.exe –p

Riproduzione in modalità raw

Usare -rawmode per riprodurre i comandi acquisiti esattamente come si sono verificati. Nella riproduzione normale, alcuni comandi vengono emulati, ad esempio un file di log di grafica acquisito da un'app a schermo intero verrà riprodotto in una finestra. Se invece è abilitata la modalità raw, lo stesso file verrà riprodotto a schermo intero.

DXCap.exe –p regression_test_12.vsglog -rawmode

Riproduzione con dispositivo WARP o hardware

Potrebbe essere necessario forzare la riproduzione di un file di log di grafica acquisito su un dispositivo hardware all'uso di WARP o forzare la riproduzione di un log acquisito su WARP all'uso di un dispositivo hardware. Usare -warp per eseguire la riproduzione con WARP.

DXCap.exe –p regression_test_12.vsglog -warp

Usare -hw per eseguire la riproduzione con un dispositivo hardware.

DXCap.exe –p regression_test_12.vsglog -hw

Convalida di un file di log di grafica per un dispositivo WARP

In modalità di convalida, il file di log di grafica viene riprodotto sia su dispositivo hardware che WARP confrontando i relativi risultati. Ciò consente di identificare gli errori di rendering causati dal driver. Usare –v per convalidare il comportamento corretto dell'hardware grafico per un dispositivo WARP.

DXCap.exe -v regression_test_12.vsglog

Per ridurre la quantità di confronti, è possibile specificare un subset di comandi per la convalida da confrontare e gli altri comandi verranno ignorati. Usare –examine per specificare i comandi di cui confrontare i risultati.

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

Conversione di un file di log di grafica in formato PNG

Per visualizzare o analizzare i frame da un file di log di grafica, DXCap.exe può salvare i frame acquisiti come file di immagine con estensione PNG (Portable Network Graphics). Usare -screenshot in modalità di riproduzione per restituire i frame acquisiti come file PNG.

DXCap.exe -p BasicHLSL11.vsglog -screenshot

Usare –frame con –screenshot per specificare i frame da restituire.

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

Conversione di un file di log di grafica in formato XML

Per elaborare e analizzare i log di grafica usando strumenti familiari come FindStr o XSLT, DXCap.exe può convertire un file di log di grafica in formato XML. Usare -toXML in modalità di riproduzione per convertire il log in formato XML anziché riprodurlo.

DXCap.exe –p regression_test_12.vsglog –toXML

Per impostazione predefinita, l'output XML viene scritto in un file con lo stesso nome del log di grafica, ma con estensione XML. Nell'esempio precedente, il file XML verrà denominato regression_test_12.xml. Per assegnare al file XML un nome diverso, specificarlo dopo -toXML.

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

Il file risultante conterrà un codice XML simile al seguente:

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