Microsoft.Direct3D.DirectStorage 1.1.0

DirectStorage SDK

This package contains the DirectStorage SDK, including the redistributable binaries.

For help getting started and other information for DirectStorage, please see:

https://aka.ms/DirectStorage

Changelog

1.1.0

New Features

• Add support for GPU decompression and GDeflate:
  • New compression format: DSTORAGE_COMPRESSION_FORMAT_GDEFLATE
  • New interface: IDStorageCustomCompressionQueue1
  • New function: DStorageCreateCompressionCodec
  • New interface: IDStorageCompressionCodec
• New interace: IDStorageQueue1:
  • New method EnqueueSetEvent() that allows a Win32 event to be signaled directly by DirectStorage.
• Add more warnings for invalid queue capacity, and invalid request fields.

Bug Fixes

• Fix hang when processing memory sourced requests that exceed in total the total size of the available staging buffer size.
• Fix running on Windows Server 2016.
• Add note in dstorage.h about how IDStorageFile::Close() doesn't affect the reference count.
• Fail enqueued requests that require a D3D device on queues that were created without one.
• For requests to GPU destinations (e.g. buffers, subresources), support requests that have uncompressed size greater than the destination size.

Breaking Changes

1.1.0 is source compatible with 1.0.2, but recompilation will be required so that the DirectStorage binaries match the header:

• DSTORAGE_ERROR_PARAMETERS_REQUEST::RequestName size changed from MAX_PATH to DSTORAGE_REQUEST_MAX_NAME.
• New DSTORAGE_CONFIGURATION fields.

This is a trade-off between having a simpler API and binary compatibility. As DirectStorage is now more feature complete with GPU decompression, binary compatibility will become a higher priority.

Known Issues

• On older versions of D3D12, the debug layer may generate incorrect warnings that there are simultaneous writes to the input staging buffer from the copy queue that brings the data into the buffer and the compute queue that performs GPU decompression.
  • As a workaround, you can use the Agility SDK: https://devblogs.microsoft.com/directx/gettingstarted-dx12agility/.

1.0.2

Breaking Changes

• Update NuGet package layout to be consistent with other native NuGet packages.

New Features

• Add DSTORAGE_CUSTOM_DECOMPRESSION_FLAGS; these can be used to determine if the destination for a custom decompression requests is in write-combined memory.

Bug Fixes

• Fix building on x86.
• Improve documentation.

Performance Improvements

• Improve Windows 10 performance.

1.0.0

First release.