structure D3DDDI_ALLOCATIONLIST (d3dukmdt.h)

Article
02/23/2024

La structure D3DDDI_ALLOCATIONLIST décrit des informations sur une spécification d’allocation utilisée dans la mise en mémoire tampon d’accès direct à la mémoire (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 le membre 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 définition de la valeur 1 indique que l’allocation peut être écrite dans.

Définir ce membre équivaut à définir le premier bit du membre Value 32 bits (0x00000001).

DoNotRetireInstance

[in] UINT qui peut contenir des informations sur la possibilité de mettre hors service l’allocation. La définition de la valeur 1 indique que le gestionnaire de mémoire vidéo ne doit pas retirer la instance de l’allocation, car le pilote la référencera à 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 supprimées. Cet indicateur est rarement utilisé.

La définition de ce membre équivaut à définir le deuxième bit du membre Value 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 la réutilisation.

Si OfferPriority n’a pas la valeur D3DDDI_OFFER_PRIORITY_NONE, l’allocation est considérée comme 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 Value 32 bits (0x0000001C).

Pris 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 des informations sur une spécification d’allocation utilisée dans la mise en mémoire tampon DMA.