DSTORAGE_CONFIGURATION1-Struktur (dstorage.h)

DirectStorage-Konfiguration; fügt eine Option zum Aktivieren des Dateipuffers hinzu. Die Nullinitialisierung führt zu den Standardwerten.

Syntax

struct DSTORAGE_CONFIGURATION1 {
  UINT32 NumSubmitThreads;
  INT32 NumBuiltInCpuDecompressionThreads;
  BOOL   ForceMappingLayer;
  BOOL   DisableBypassIO;
  BOOL   DisableTelemetry;
  BOOL   DisableGpuDecompressionMetacommand;
  BOOL   DisableGpuDecompression;
  BOOL   ForceFileBuffering;
};

Member

NumSubmitThreads

Legt die Anzahl der Threads fest, die für die Übermittlung von E/A-Vorgängen verwendet werden sollen. Wenn Sie 0 angeben, verwenden Sie die beste Schätzung des Systems zu einem guten Wert. Standardwert == 0.

NumBuiltInCpuDecompressionThreads

Legt die Anzahl der Threads fest, die von der DirectStorage-Runtime zum Dekomprimieren von Daten mithilfe der CPU für integrierte komprimierte Formate verwendet werden sollen, die nicht mit der GPU dekomprimiert werden können. Die Angabe von 0 bedeutet, die beste Schätzung des Systems zu einem guten Wert zu verwenden. Das Angeben DSTORAGE_DISABLE_BUILTIN_CPU_DECOMPRESSION bedeutet, dass keine Dekomprimierungsthreads erstellt werden, und der Titel ist vollständig für die Überprüfung der benutzerdefinierten Dekomprimierungswarteschlange und das Abrufen aller Einträge zum Dekomprimieren verantwortlich. Standardwert == 0.

ForceMappingLayer

Erzwingt die Verwendung der E/A-Zuordnungsebene, auch wenn sie unter einem Betriebssystem ausgeführt wird, das sie nicht erfordert. Dies kann während der Entwicklung nützlich sein, sollte aber für die Veröffentlichung auf FALSE festgelegt werden. Standardwert == FALSE.

DisableBypassIO

Deaktiviert die Verwendung der Umgehungs-E/A-Optimierung, auch wenn sie verfügbar ist. Dies kann während der Entwicklung nützlich sein, sollte aber für die Veröffentlichung auf FALSE festgelegt werden. Es sei denn, Sie legen ForceFileBuffering auf fest TRUE. Standardwert == FALSE.

DisableTelemetry

Deaktiviert die Berichterstellung von Telemetriedaten, wenn auf TRUEfestgelegt ist. Telemetriedaten sind in der DirectStorage-Runtime standardmäßig aktiviert. Standardwert == FALSE.

DisableGpuDecompressionMetacommand

Deaktiviert die Verwendung eines Dekomprimierungsmetabefehls, auch wenn ein Metabefehl verfügbar ist. Dadurch erzwingt die Runtime, den integrierten GPU-Dekomprimierungs-Fallback-Shader zu verwenden. Dies kann während der Entwicklung nützlich sein, sollte aber für die Veröffentlichung auf FALSE festgelegt werden. Standardwert == FALSE.

DisableGpuDecompression

Deaktiviert die Verwendung der GPU-basierten Dekomprimierung, auch wenn sie verfügbar ist. Dadurch erzwingt die Runtime, die CPU zu verwenden. Standardwert == FALSE.

ForceFileBuffering

Erzwingt die Verwendung der integrierten Dateizwischenspeicherungsverhalten, die im Windows-Betriebssystem unterstützt werden, indem beim Öffnen von Dateien keine FILE_FLAG_NO_BUFFERING festgelegt wird (siehe Dateipufferung). Standardwert == FALSE.

Sie müssen DisableBypassIOTRUE auf festlegen, wenn Sie diese Option verwenden, andernfalls wird E_DSTORAGE_FILEBUFFERING_REQUIRES_DISABLED_BYPASSIO zurückgegeben. Es liegt in der Verantwortung des Titels zu wissen, wann diese Einstellung verwendet werden soll. Dieses Feature sollte nur für langsamere HDD-Laufwerke aktiviert werden, die von den Funktionen zum Puffern von Betriebssystemdateien profitieren.

Warnung

Das Aktivieren des Dateipuffers auf Hochgeschwindigkeitslaufwerken kann die Gesamtleistung beim Lesen von diesem Laufwerk beeinträchtigen, da BypassIO ebenfalls deaktiviert ist.

Anforderungen

Kopfzeile	dstorage.h