DXGKARG_OPENALLOCATION Struktur (d3dkmddi.h)

Artikel
02/06/2025

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;

Angehörige

[in] NumAllocations

Die Anzahl der Elemente im Array, die der pOpenAllocation Member angibt, der die Anzahl der gerätespezifischen Zuordnungen darstellt, die geöffnet werden sollen.

[in/out] pOpenAllocation

Ein Array von DXGK_OPENALLOCATIONINFO Strukturen für die zu öffnenden Zuordnungen.

[in] pPrivateDriverData

Ein Zeiger auf einen Block privater Daten, der vom Anzeigetreiber für den Benutzermodus an den Miniporttreiber übergeben wird. Dieser Block privater Daten ist die gleiche ressourcenspezifische Daten, die im pPrivateDriverData Member der DXGKARG_CREATEALLOCATION Struktur im Aufruf der DxgkDdiCreateAllocation-Funktion übergeben werden. Der Miniporttreiber für die Anzeige kann diesen Block privater Daten nicht ändern.

[in] PrivateDriverSize

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

[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 dieses Element nur an, wenn der Anzeige-Miniporttreiber GDI Hardware Accelerationunterstützt. Insbesondere muss der Anzeigeminiporttreiber die DxgkDdiRenderKm--Funktion implementieren und das Gerät mit dem GdiDevice Membersatz in DXGKARG_CREATEDEVICEerstellen.Flags.

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

[out] SubresourceOffset

Wird ab Windows 8 unterstützt.

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

[out] Pitch

Wird ab Windows 8 unterstützt.

Der Abstand (in Byte) der Zuordnung , d. h. der Abstand in Bytes bis zum Anfang der nächsten Zeile.