D3DDDI_ALLOCATIONLIST Struktur (d3dukmdt.h)

2025-02-06

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;

Angehörige

hAllocation

[in] Der von der D3DKMTOpenResource Funktion im hAllocation Member der D3DDDI_OPENALLOCATIONINFO Struktur zurückgegebene Zuordnungshandle oder durch die D3DKMTCreateAllocation Funktion im hAllocation Member der D3DDDI_ALLOCATIONINFO Struktur.

WriteOperation

[in] Ein UINT, der Informationen darüber enthalten kann, in 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-Value Members (0x00000001).

DoNotRetireInstance

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

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

OfferPriority

[in] Ein Wert aus der D3DDDI_OFFER_PRIORITY Enumeration, der die Wichtigkeit von Videospeicherressourcen angibt, die der Anzeigetreiber für den Benutzermodus zur Wiederverwendung bietet.

Wenn OfferPriority- keinen Wert von D3DDDI_OFFER_PRIORITY_NONEhat, wird die Zuordnung nach der Verarbeitung des DMA-Puffers als angeboten betrachtet.

Das Festlegen dieses Elements entspricht dem Festlegen von Bits 3 bis 5 des 32-Bit-Value Members (0x0000001C).

Wird ab Windows 8 unterstützt.

Reserved

[in] Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Value

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