Microsoft.Direct3D.DirectStorage 1.1.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

There is a newer version of this package available.
See the version list below for details.

dotnet add package Microsoft.Direct3D.DirectStorage --version 1.1.0

NuGet\Install-Package Microsoft.Direct3D.DirectStorage -Version 1.1.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Microsoft.Direct3D.DirectStorage" Version="1.1.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Microsoft.Direct3D.DirectStorage --version 1.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Microsoft.Direct3D.DirectStorage, 1.1.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Microsoft.Direct3D.DirectStorage as a Cake Addin
#addin nuget:?package=Microsoft.Direct3D.DirectStorage&version=1.1.0

// Install Microsoft.Direct3D.DirectStorage as a Cake Tool
#tool nuget:?package=Microsoft.Direct3D.DirectStorage&version=1.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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.