DXGKARG_OPENALLOCATION Struktur (d3dkmddi.h)

Artikel
02/23/2024

Die DXGKARG_OPENALLOCATION-Struktur beschreibt Zuordnungen, die der Anzeigeminiporttreiber öffnen soll.

Syntax

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Member

[in] NumAllocations

Die Anzahl der Elemente in dem Array, die vom pOpenAllocation-Member angegeben wird, was die Anzahl der gerätespezifischen Zuordnungen darstellt, die geöffnet werden sollen.

[in/out] pOpenAllocation

Ein Array von DXGK_OPENALLOCATIONINFO Strukturen, die die Zuordnungen öffnen sollen.

[in] pPrivateDriverData

Ein Zeiger auf einen Block privater Daten, der vom Benutzermodusanzeigetreiber an den Anzeigeminiporttreiber übergeben wird. Bei diesem Block privater Daten handelt es sich um dieselben ressourcenspezifischen Daten, die im pPrivateDriverData-Member der DXGKARG_CREATEALLOCATION-Struktur im Aufruf der DxgkDdiCreateAllocation-Funktion übergeben werden. Der Anzeigeminiporttreiber kann diesen Block privater Daten nicht ändern.

[in] PrivateDriverSize

Die Größe des Blocks privater Daten, auf den pPrivateDriverData verweist, in Bytes.

[in] Flags

Eine DXGK_OPENALLOCATIONFLAGS Struktur, die den vorgang identifiziert, der für Zuordnungen ausgeführt werden soll.

[in] SubresourceIndex

Wird ab Windows 8 unterstützt.

Ein Index in der Ressource für die Renderzieloberfläche.

Das Betriebssystem gibt diesen Member nur an, wenn der Anzeigeminiporttreiber die GDI-Hardwarebeschleunigung unterstützt. Insbesondere muss der Anzeigeminiporttreiber die DxgkDdiRenderKm-Funktion implementieren und das Gerät mit dem GdiDevice-Member in DXGKARG_CREATEDEVICE erstellen. Flags.

Wenn der Wert von SubresourceIndex größer als die Anzahl der Unterressourcen in der Zuordnung ist, sollte der Anzeigeminiporttreiber einen Fehler zurückgeben.

[out] SubresourceOffset

Wird ab Windows 8 unterstützt.

Der Offset in Bytes vom Anfang der Zuordnung bis zum Anfang der Unterquelle.

[out] Pitch

Wird ab Windows 8 unterstützt.

Die Tonhöhe der Zuordnung in Bytes, d. h. der Abstand in Bytes zum Anfang der nächsten Zeile.