Décompression matérielle facile

Les consoles XBOX Series prennent en charge la décompression matérielle du contenu compressé avec zlib à l’aide de DirectStorage. Vous trouverez ici un remplacement direct de la fonction logicielle inflate standard de zlib. L’utilisation de ce code peut permettre à un développeur d’ajouter la prise en charge de la décompression matérielle accélérée avec le minimum de modifications à son code. Elle procurera une amélioration immédiate des temps de décompression tout en libérant des ressources du processeur qui pourront servir à d’autres tâches. Une initialisation unique est nécessaire pour créer les objets DirectStorage utilisés pour la décompression matérielle.

Microsoft::WRL::ComPtr<IDStorageFactoryX> inflateDropInFactory;
Microsoft::WRL::ComPtr<IDStorageQueueX> inflateDropInQueue;
Microsoft::WRL::ComPtr<IDStorageStatusArrayX> inflateDropInStatus;

void CreateDSObjects()
{
    DX::ThrowIfFailed(DStorageGetFactory(__uuidof(IDStorageFactoryX), (void**)(inflateDropInFactory.ReleaseAndGetAddressOf())));
    DSTORAGE_QUEUE_DESC queueDesc = {};
    queueDesc.SourceType = DSTORAGE_REQUEST_SOURCE_MEMORY;
    queueDesc.Priority = DSTORAGE_PRIORITY_REALTIME;
    queueDesc.Capacity = DSTORAGE_MIN_QUEUE_CAPACITY;
    inflateDropInFactory->CreateQueue(&queueDesc, __uuidof(IDStorageQueueX), (void**)(inflateDropInQueue.ReleaseAndGetAddressOf()));
    inflateDropInFactory->CreateStatusArray(1, nullptr, __uuidof(IDStorageStatusArrayX), (void**)(inflateDropInStatus.ReleaseAndGetAddressOf()));
}

La décompression matérielle comporte un coût de configuration minimal; c’est pourquoi il peut être plus rapide d’utiliser la décompression logicielle pour les blocs de petite taille. Un tableau des temps est fourni ci-dessous, avec du texte ASCII comme mémoire tampon source. Vous devriez effectuer un profilage pour trouver la meilleure taille de croisement par rapport à votre décompresseur logiciel et à votre contenu. Ce code suppose que le contenu compressé est conforme à la norme zlib IETF RFC 1950 prise en charge. Consultez Optimisation du contenu compressé à l’aide de DirectStorage et XBTC (microsoft.com) pour plus de détails.

int inflateDropIn(z_streamp strm, int flush)
{
    bool fallback(false);
    if (strm->avail_out <= strm->total_in)
        fallback = true;
    if (flush != Z_FINISH)
        fallback = true;
    if (strm->avail_out < c_hardwareSizeCrossOverSize)
        fallback = true;
    if (fallback)
        return inflate(strm, flush);

    DSTORAGE_REQUEST request = {};
    request.Options.ZlibDecompress = true;
    request.Options.SourceType = DSTORAGE_REQUEST_SOURCE_MEMORY;
    request.Source = strm->next_in;
    request.SourceSize = strm->total_in;
    request.Destination = strm->next_out;
    request.DestinationSize = strm->avail_out;
    inflateDropInQueue->EnqueueRequest(&request);
    inflateDropInQueue->EnqueueStatus(inflateDropInStatus.Get(), 0);
    inflateDropInQueue->Submit();
    while (!inflateDropInStatus->IsComplete(0))
    {
        _mm_pause();
    }
    return Z_STREAM_END;
}

Ce tableau présente une mesure des temps du décompresseur logiciel zlib standard par rapport au décompresseur matériel d’une XBOX Series X|S fonctionnant à 3,8 GHz, avec du texte ASCII comme mémoire tampon source. Des taux de compression différents créeront des points de croisement différents quant à la solution la plus rapide entre le logiciel et le matériel. Vous devriez effectuer un profilage pour trouver la meilleure taille de croisement par rapport à votre décompresseur logiciel et à votre contenu. La taille de bloc est exprimée en octets et les temps en microsecondes.

Taille de bloc	Temps processeur	Temps matériel
128	2.91	75.39
256	3.67	65.29
512	4.14	65.54
1,024	5.59	66.63
2,048	7.65	66.29
4,096	10.96	83.93
8,192	13.69	69.04
10,240	15.08	67.09
12,288	16.16	67.66
14,336	17.37	70.58
16,384	18.40	72.56
20,480	20.58	70.34
24,576	22.88	71.52
28,672	25.34	71.34
32,768	27.71	73.03
36,864	29.73	72.35
40,960	31.56	77.67
45,056	34.34	73.22
65,536	46.76	76.69
131,072	83.96	89.13
262,144	158.32	111.58
524,288	308.01	177.95

Introduction

Onboarding & Access

Setup & Install

Build Your First Title