DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA Struktur (d3dkmddi.h)

Artikel
11/11/2024

Die DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA Struktur beschreibt einen Standardzuordnungstyp.

Syntax

typedef struct _DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA {
  D3DKMDT_STANDARDALLOCATION_TYPE StandardAllocationType;
  union {
    D3DKMDT_SHAREDPRIMARYSURFACEDATA *pCreateSharedPrimarySurfaceData;
    D3DKMDT_SHADOWSURFACEDATA        *pCreateShadowSurfaceData;
    D3DKMDT_STAGINGSURFACEDATA       *pCreateStagingSurfaceData;
    D3DKMDT_GDISURFACEDATA           *pCreateGdiSurfaceData;
    D3DKMDT_VIRTUALGPUSURFACEDATA    *pCreateVirtualGpuSurfaceData;
    D3DKMDT_FENCESTORAGESURFACEDATA  *pCreateFenceStorageData;
  };
  VOID                            *pAllocationPrivateDriverData;
  UINT                            AllocationPrivateDriverDataSize;
  VOID                            *pResourcePrivateDriverData;
  UINT                            ResourcePrivateDriverDataSize;
  UINT                            PhysicalAdapterIndex;
} DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA;

Angehörige

StandardAllocationType

[in] Ein D3DKMDT_STANDARDALLOCATION_TYPE-typed-Wert, der den Typ der zu beschreibenden Standardzuordnung identifiziert.

pCreateSharedPrimarySurfaceData

[in] Ein Zeiger auf eine D3DKMDT_SHAREDPRIMARYSURFACEDATA Struktur, wenn StandardAllocationType- D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE angibt.

pCreateShadowSurfaceData

[in] Ein Zeiger auf eine D3DKMDT_SHADOWSURFACEDATA Struktur, wenn StandardAllocationType- D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE angibt.

pCreateStagingSurfaceData

[in] Ein Zeiger auf eine D3DKMDT_STAGINGSURFACEDATA Struktur, wenn StandardAllocationType- D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE angibt.

pCreateGdiSurfaceData

[in] Ein Zeiger auf eine D3DKMDT_GDISURFACEDATA Struktur, nur verfügbar, wenn StandardAllocationType- D3DKMDT_STANDARDALLOCATION_GDISURFACE angibt.

Dieses Mitglied ist ab Windows 7 verfügbar.

pCreateVirtualGpuSurfaceData

Zeiger auf eine D3DKMDT_VIRTUALGPUSURFACEDATA Struktur, wenn StandardAllocationType-D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACEist. Verfügbar ab WDDM 2.1.

pCreateFenceStorageData

Zeiger auf eine D3DKMDT_FENCESTORAGESURFACEDATA Struktur, wenn StandardAllocationType-D3DKMDT_STANDARDALLOCATION_FENCESTORAGEist. Verfügbar ab WDDM 3.2.

pAllocationPrivateDriverData

[in/out] Ein Zeiger auf einen Block privater Zuordnungsdaten, der den Standardzuordnungstyp beschreibt; andernfalls ist dieses Element NULL. Die privaten Zuordnungsdaten, die der Miniporttreiber (KMD) DxgkDdiGetStandardAllocationDriverData--Funktion zurückgibt, hängt vom Typ ab, den der Treiber in StandardAllocationTypeanfordert.

AllocationPrivateDriverDataSize

[out] Die Größe der privaten Zuteilungsdaten in Bytes, auf die pAllocationPrivateDriverData verweist. Wenn der Treiber pAllocationPrivateDriverData- auf NULL festlegt, sollte der Treiber AllocationPrivateDriverDataSize- auf die Größe des Puffers festlegen, den der Treiber zum Beschreiben des angegebenen Standardzuordnungstyps benötigt.

Wenn der Treiber keine privaten Daten für jede Zuordnung für Standardzuordnungstypen verwendet, kann der Treiber AllocationPrivateDriverDataSize auf Null festlegen.

pResourcePrivateDriverData

[in/out] Ein Zeiger auf einen Block privater Ressourcendaten, der den Standardzuordnungstyp beschreibt; andernfalls ist dieses Element NULL. Die privaten Ressourcendaten, die die DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers zurückgeben, hängt vom Typ ab, den der Treiber in StandardAllocationTypeanfordert.

ResourcePrivateDriverDataSize

[out] Die Größe der privaten Ressourcendaten in Byte, auf die pResourcePrivateDriverData verweist. Wenn der Treiber pResourcePrivateDriverData- auf NULL festlegt, sollte der Treiber ResourcePrivateDriverDataSize auf die Größe des Puffers festlegen, den der Treiber zum Beschreiben des angegebenen Standardzuordnungstyps benötigt.

Wenn der Treiber keine privaten Daten für jede Ressource für Standardzuordnungstypen verwendet, kann der Treiber ResourcePrivateDriverDataSize auf Null festlegen.

PhysicalAdapterIndex

[in] Der Index des physischen Adapters in einer LDA-Konfiguration, in der sich der Speicher befindet.

Bemerkungen

Standardzuordnungstypen sind Zuordnungen, die im Kernelmodus erstellt werden müssen, ohne vom Anzeigetreiber für den Benutzermodus zu kommunizieren.

Wenn der Kernelmodus-Miniporttreiber (KMD) in der pAllocationPrivateDriverData und pResourcePrivateDriverData Member NULL zurückgibt, sollte er die Größen der Puffer zurückgeben, die in den AllocationPrivateDriverDataSize und ResourcePrivateDriverDataSize Member erforderlich sind. Der KMD sollte jedoch nicht den Inhalt der Standardzuordnungsstruktur in der Union ändern, die DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA enthält, um die erforderlichen Größen der Puffer abzurufen.

Obwohl KMD ResourcePrivateDriverDataSize- oder AllocationPrivateDriverDataSize- auf Null festlegen kann, kann sie nicht auf Null festgelegt werden.