structure D3DDDI_ALLOCATIONLIST (d3dukmdt.h)

Article
02/06/2025

La structure D3DDDI_ALLOCATIONLIST décrit des informations sur une spécification d’allocation utilisée dans la mise en mémoire tampon directe (DMA).

Syntaxe

typedef struct _D3DDDI_ALLOCATIONLIST {
  D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation : 1;
      UINT DoNotRetireInstance : 1;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

Membres

hAllocation

[in] Handle d’allocation retourné par la fonction D3DKMTOpenResource dans la fonction hAllocation de la structure D3DDDI_OPENALLOCATIONINFO, ou par la fonction D3DKMTCreateAllocation dans le membre hAllocation de la structure D3DDDI_ALLOCATIONINFO.

WriteOperation

[in] UINT qui peut contenir des informations sur l’écriture de l’allocation. La valeur 1 indique que l’allocation peut être écrite.

La définition de ce membre équivaut à définir le premier bit du membre valeur de 32 bits (0x00000001).

DoNotRetireInstance

[in] UINT qui peut contenir des informations sur la suppression de l’allocation. La valeur 1 indique que le gestionnaire de mémoire vidéo ne doit pas mettre hors service l’instance de l’allocation, car le pilote la référence à nouveau dans une mémoire tampon DMA ultérieure (par exemple, une diffusion manuelle d’une mémoire tampon DMA vers plusieurs contextes). Toutes les instances d’une allocation sont finalement retirées. Cet indicateur est rarement utilisé.

La définition de ce membre équivaut à définir le deuxième bit du membre valeur 32 bits (0x00000002).

OfferPriority

[in] Valeur de l’énumération D3DDDI_OFFER_PRIORITY qui indique l’importance des ressources de mémoire vidéo que le pilote d’affichage en mode utilisateur offre pour réutilisation.

Si offerPriority n’a pas de valeur de D3DDDI_OFFER_PRIORITY_NONE, l’allocation est considérée comme étant proposée après le traitement de la mémoire tampon DMA.

La définition de ce membre équivaut à définir les bits 3 à 5 du membre valeur 32 bits (0x0000001C).

Prise en charge à partir de Windows 8.

Reserved

[in] Ce membre est réservé et doit être défini sur zéro.

Value

[in] Valeur 32 bits qui identifie les informations relatives à une spécification d’allocation utilisée dans la mise en mémoire tampon DMA.