structure D3DDDI_ALLOCATIONLIST (d3dukmdt.h)

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 {
  [in] D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation : 1;
      UINT DoNotRetireInstance : 1;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    [in] UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

Membres

[in] hAllocation

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 .

[in] WriteOperation

UINT qui peut contenir des informations sur la possibilité d’écrire 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 32 bits (0x00000001).

[in] DoNotRetireInstance

UINT qui peut contenir des informations sur la mise hors service 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 le 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 supprimé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).

[in] OfferPriority

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 de 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 Valeur 32 bits (0x0000001C).

Prise en charge à partir de Windows 8.

[in] Reserved

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

La définition de ce membre sur zéro équivaut à définir les 27 bits restants (0xFFFFFFE0) du membre Valeur 32 bits sur zéros.

Prise en charge à partir de Windows 8.

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

La définition de ce membre sur zéro équivaut à définir les 30 bits restants (0xFFFFFFFC) du membre Valeur 32 bits sur zéros.

[in] Value

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

Spécifications

   
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête d3dukmdt.h (include D3dumddi.h, D3dkmddi.h)

Voir aussi

CreateDevice

D3DDDIARG_CREATEDEVICE

D3DDDICB_RENDER

D3DDDI_OFFER_PRIORITY

pfnRenderCb