D3DDDI_ALLOCATIONLIST-Struktur (d3dukmdt.h)

Artikel
02/23/2024

Die D3DDDI_ALLOCATIONLIST-Struktur beschreibt Informationen zu einer Zuordnungsspezifikation, die in der DMA-Pufferung (Direct Memory Access) verwendet wird.

Syntax

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;

Member

hAllocation

[in] Das Zuordnungshandle, das von der Funktion D3DKMTOpenResource im hAllocation-Element der D3DDDI_OPENALLOCATIONINFO-Struktur oder von der D3DKMTCreateAllocation-Funktion im hAllocation-Element der D3DDDI_ALLOCATIONINFO-Struktur zurückgegeben wird.

WriteOperation

[in] Ein UINT, der Informationen darüber enthalten kann, ob die Zuordnung geschrieben werden kann. Die Einstellung auf 1 gibt an, dass die Zuordnung geschrieben werden kann.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Elements Wert (0x00000001).

DoNotRetireInstance

[in] Ein UINT, der Informationen darüber enthalten kann, ob die Zuordnung eingestellt werden kann. Die Einstellung auf 1 gibt an, dass der Videospeicher-Manager die instance der Zuordnung nicht außer Kraft setzen sollte, da der Treiber in einem nachfolgenden DMA-Puffer erneut darauf verweist (z. B. eine manuelle Übertragung eines DMA-Puffers in mehrere Kontexte). Alle Instanzen einer Zuordnung werden schließlich eingestellt. Dieses Flag wird selten verwendet.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertmembers (0x00000002).

OfferPriority

[in] Ein Wert aus der D3DDDI_OFFER_PRIORITY-Enumeration , der die Bedeutung der Videospeicherressourcen angibt, die der Benutzermodusanzeigetreiber für die Wiederverwendung bereitstellt.

Wenn OfferPriority nicht über den Wert D3DDDI_OFFER_PRIORITY_NONE verfügt, gilt die Zuordnung als angeboten, nachdem der DMA-Puffer verarbeitet wurde.

Das Festlegen dieses Elements entspricht dem Festlegen der Bits 3 bis 5 des 32-Bit-Wert-Elements (0x0000001C).

Unterstützt ab Windows 8.

Reserved

[in] Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Value

[in] Ein 32-Bit-Wert, der Informationen zu einer Zuordnungsspezifikation identifiziert, die bei der DMA-Pufferung verwendet wird.