estructura DSTORAGE_CONFIGURATION1 (dstorage.h)

Configuración de DirectStorage; agrega una opción para habilitar el almacenamiento en búfer de archivos. La inicialización cero dará como resultado los valores predeterminados.

Sintaxis

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

Members

NumSubmitThreads

Establece el número de subprocesos que se van a usar para enviar operaciones de E/S. Especificar 0 significa usar la mejor estimación del sistema en un buen valor. Valor predeterminado == 0.

NumBuiltInCpuDecompressionThreads

Establece el número de subprocesos que va a usar el entorno de ejecución de DirectStorage para descomprimir datos mediante la CPU para formatos comprimidos integrados que no se pueden descomprimir mediante la GPU. Especificar 0 significa usar la mejor estimación del sistema en un buen valor. Especificar DSTORAGE_DISABLE_BUILTIN_CPU_DECOMPRESSION significa que no se creará ningún subproceso de descompresión y el título es totalmente responsable de comprobar la cola de descompresión personalizada y extraer todas las entradas para descomprimir. Valor predeterminado == 0.

ForceMappingLayer

Fuerza el uso de la capa de asignación de E/S, incluso cuando se ejecuta en un sistema operativo que no lo requiere. Esto puede ser útil durante el desarrollo, pero debe establecerse FALSE en para la versión. Valor predeterminado == FALSE.

DisableBypassIO

Deshabilita el uso de la optimización de E/S de omisión, incluso si está disponible. Esto puede ser útil durante el desarrollo, pero debe establecerse FALSE en para la versión; a menos que establezca ForceFileBuffering en TRUE. Valor predeterminado == FALSE.

DisableTelemetry

Deshabilita los informes de datos de telemetría cuando se establece en TRUE. Los datos de telemetría están habilitados de forma predeterminada en el entorno de ejecución de DirectStorage. Valor predeterminado == FALSE.

DisableGpuDecompressionMetacommand

Deshabilita el uso de un metacomando de descompresión, incluso si hay uno disponible. Esto obligará al tiempo de ejecución a usar el sombreador de reserva de descompresión de GPU integrado. Esto puede ser útil durante el desarrollo, pero debe establecerse FALSE en para la versión. Valor predeterminado == FALSE.

DisableGpuDecompression

Deshabilita el uso de descompresión basada en GPU, incluso si está disponible. Esto obligará al tiempo de ejecución a usar la CPU. Valor predeterminado == FALSE.

ForceFileBuffering

Fuerza el uso de los comportamientos de almacenamiento en caché de archivos integrados admitidos en el sistema operativo Windows al no establecer FILE_FLAG_NO_BUFFERING al abrir archivos (consulte Almacenamiento en búfer de archivos). Valor predeterminado == FALSE.

Debe establecer DisableBypassIOTRUE en al usar esta opción; de lo contrario, se devolverá E_DSTORAGE_FILEBUFFERING_REQUIRES_DISABLED_BYPASSIO . Es responsabilidad del título saber cuándo usar esta configuración. Esta característica solo debe habilitarse para unidades hdD más lentas que se beneficiarán de las características de almacenamiento en búfer de archivos del sistema operativo.

Advertencia

Habilitar el almacenamiento en búfer de archivos en unidades de alta velocidad podría reducir el rendimiento general al leer desde esa unidad porque BypassIO también está deshabilitado.

Requisitos

Encabezado	dstorage.h