DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA Struktur (d3dkmddi.h)

Artikel
12/21/2023

Die DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA-Struktur beschreibt einen Standardzuordnungstyp.

Syntax

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

Member

[in] StandardAllocationType

Ein D3DKMDT_STANDARDALLOCATION_TYPE typisierter Wert, der den Typ der zu beschreibenden Standardzuordnung angibt.

[in] pCreateSharedPrimarySurfaceData

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

[in] pCreateShadowSurfaceData

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

[in] pCreateStagingSurfaceData

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

[in] pCreateGdiSurfaceData

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 StandardAllocationTypeD3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE ist. Verfügbar ab WDDM 2.1.

[in/out] pAllocationPrivateDriverData

Ein Zeiger auf einen Block privater Zuordnungsdaten, der den Standardzuordnungstyp beschreibt; andernfalls ist dieser Member NULL. Die privaten Zuordnungsdaten, die die DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers zurückgibt, hängen vom Typ ab, den der Treiber in StandardAllocationType anfordert.

[out] AllocationPrivateDriverDataSize

Die Größe der privaten Zuordnungsdaten 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 0 festlegen.

[in/out] pResourcePrivateDriverData

Ein Zeiger auf einen Block privater Ressourcendaten, der den Standardzuordnungstyp beschreibt; andernfalls ist dieser Member NULL. Die privaten Ressourcendaten, die die DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers zurückgibt, hängen vom Typ ab, den der Treiber in StandardAllocationType anfordert.

[out] ResourcePrivateDriverDataSize

Die Größe der privaten Ressourcendaten in Bytes, auf die pResourcePrivateDriverData verweist. Wenn der Treiber pResourcePrivateDriverData auf NULL festlegt, sollte der Treiber ResourcePrivateDriverDataSize auf die Größe des Puffers festlegen, die 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 0 festlegen.

PhysicalAdapterIndex

Hinweise

Wenn der Anzeigeminiporttreiber null in den Membern pAllocationPrivateDriverData und pResourcePrivateDriverData zurückgibt, sollte der Treiber die Größe der Puffer zurückgeben, die der Treiber in den Membern AllocationPrivateDriverDataSize und ResourcePrivateDriverDataSize benötigt. Der Treiber sollte jedoch nicht den Inhalt der Standardzuordnungsstruktur in der Union ändern, die DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA enthält, um die erforderlichen Größen der Puffer zu erhalten.

Obwohl der Treiber ResourcePrivateDriverDataSize oder AllocationPrivateDriverDataSize auf Null festlegen kann, kann der Treiber nicht beide auf 0 festlegen.