D3DDisassembleRegion-Funktion (d3dcompiler.h)

Artikel
03/01/2024

Disassembliert eine bestimmte Region mit kompiliertem HlSL-Code (Microsoft High Level Shader Language).

Syntax

HRESULT D3DDisassembleRegion(
  [in]            LPCVOID  pSrcData,
  [in]            SIZE_T   SrcDataSize,
  [in]            UINT     Flags,
  [in, optional]  LPCSTR   szComments,
  [in]            SIZE_T   StartByteOffset,
  [in]            SIZE_T   NumInsts,
  [out, optional] SIZE_T   *pFinishByteOffset,
  [out]           ID3DBlob **ppDisassembly
);

Parameter

[in] pSrcData

Ein Zeiger auf kompilierte Shaderdaten.

[in] SrcDataSize

Die Größe des Speicherblocks in Bytes, auf den pSrcData verweist.

[in] Flags

Eine Kombination aus null oder mehr der folgenden Flags, die mithilfe eines bitweisen OR-Vorgangs kombiniert werden. Der resultierende Wert gibt an, wie D3DDisassembleRegion die kompilierten Shaderdaten zerlegt.

Flag	Beschreibung
D3D_DISASM_ENABLE_COLOR_CODE (0x01)	Aktivieren Sie die Ausgabe von Farbcodes.
D3D_DISASM_ENABLE_DEFAULT_VALUE_PRINTS (0x02)	Aktivieren Sie die Ausgabe von Standardwerten.
D3D_DISASM_ENABLE_INSTRUCTION_NUMBERING (0x04)	Aktivieren Sie die Anweisungsnummerierung.
D3D_DISASM_ENABLE_INSTRUCTION_CYCLE (0x08)	Keine Auswirkung.
D3D_DISASM_DISABLE_DEBUG_INFO (0x10)	Deaktivieren Sie die Ausgabe von Debuginformationen.
D3D_DISASM_ENABLE_INSTRUCTION_OFFSET (0x20)	Aktivieren Sie die Ausgabe von Anweisungsoffsets.
D3D_DISASM_INSTRUCTION_ONLY (0x40)	Dieses Flag hat keine Auswirkung auf D3DDisassembleRegion. Zyklusinformationen stammen aus der Ablaufverfolgung; Daher sind Zyklusinformationen nur in der Ablaufverfolgungsdemontage von D3DDisassemble11Trace verfügbar.

[in, optional] szComments

Ein Zeiger auf eine konstante NULL-Zeichenfolge am oberen Rand des Shaders, der die Shaderkonstanten und Variablen identifiziert.

[in] StartByteOffset

Die Anzahl der Bytes, die in die kompilierten Shaderdaten versetzt werden, wobei D3DDisassembleRegion die Disassemblierung startet.

[in] NumInsts

Die Anzahl der zu disassemblierenden Anweisungen.

[out, optional] pFinishByteOffset

Ein Zeiger auf eine Variable, die die Anzahl der Bytes in die kompilierten Shaderdaten empfängt, wobei D3DDisassembleRegion die Disassemblierung beendet.

[out] ppDisassembly

Ein Zeiger auf einen Puffer, der die ID3DBlob-Schnittstelle empfängt, die auf den zerlegten HLSL-Code zugreift.

Rückgabewert

Gibt einen der Direct3D 11-Rückgabecodes zurück.

Hinweise

Hinweis Die D3dcompiler_44.dll oder höher der Datei enthält die Compilerfunktion D3DDisassembleRegion .

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3dcompiler.h
Bibliothek	D3DCompiler.lib
DLL	D3DCompiler_47.dll

Siehe auch

Funktionen

Freigeben über