структура DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Статья
05/23/2024

Структура DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA описывает стандартный тип выделения.

Синтаксис

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;

Члены

StandardAllocationType

[in] D3DKMDT_STANDARDALLOCATION_TYPE типизированное значение, определяющее тип стандартного выделения для описания.

pCreateSharedPrimarySurfaceData

[in] Указатель на структуру D3DKMDT_SHAREDPRIMARYSURFACEDATA , если StandardAllocationType указывает D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Указатель на структуру D3DKMDT_SHADOWSURFACEDATA , если StandardAllocationType указывает D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Указатель на структуру D3DKMDT_STAGINGSURFACEDATA , если StandardAllocationType указывает D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Указатель на структуру D3DKMDT_GDISURFACEDATA , доступный только в том случае, если StandardAllocationType указывает D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Этот элемент доступен начиная с Windows 7.

pCreateVirtualGpuSurfaceData

Указатель на структуру D3DKMDT_VIRTUALGPUSURFACEDATA , если standardAllocationType имеет D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Доступно начиная с версии WDDM 2.1.

pCreateFenceStorageData

pAllocationPrivateDriverData

[вход/выход] Указатель на блок частных данных выделения, описывающий стандартный тип выделения; в противном случае этот элемент имеет значение NULL. Частные данные выделения, возвращаемые функцией DxgkDdiGetStandardAllocationDriverData драйвера miniport, зависят от типа, запрашиваемого драйвером в StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Размер в байтах частных данных выделения, на которые указывает pAllocationPrivateDriverData . Если драйвер задает для pAllocationPrivateDriverData значение NULL, драйвер должен задать для allocationPrivateDriverDataSize размер буфера, необходимый драйверу для описания заданного стандартного типа выделения.

Если драйвер не использует частные данные для каждого выделения стандартных типов, драйвер может задать значение AllocationPrivateDriverDataSize равным нулю.

pResourcePrivateDriverData

[вход/выход] Указатель на блок частных данных ресурса, описывающий стандартный тип выделения; в противном случае этот элемент имеет значение NULL. Частные данные ресурса, возвращаемые функцией DxgkDdiGetStandardAllocationDriverData драйвера miniport, зависят от типа, запрашиваемого драйвером в StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Размер (в байтах) частных данных ресурса, на которые указывает pResourcePrivateDriverData . Если драйвер задает для pResourcePrivateDriverData значение NULL, драйвер должен задать для Параметра ResourcePrivateDriverDataSize размер буфера, необходимый драйверу для описания заданного стандартного типа выделения.

Если драйвер не использует частные данные для каждого ресурса для стандартных типов распределения, драйвер может задать для Параметра ResourcePrivateDriverDataSize значение 0.

PhysicalAdapterIndex

Если драйвер мини-порта отображения возвращает значение NULL в элементах pAllocationPrivateDriverData и pResourcePrivateDriverData , драйвер должен вернуть размеры буферов, необходимые драйверу в элементах AllocationPrivateDriverDataSize и ResourcePrivateDriverDataSize . Однако драйвер не должен изменять содержимое стандартной структуры распределения в объединении, которое DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA содержит, чтобы получить необходимые размеры буферов.

Хотя драйвер может задать для параметра ResourcePrivateDriverDataSize или AllocationPrivateDriverDataSize значение 0, драйвер не может установить для обоих нулей.