estructura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artículo
05/23/2024

La estructura de DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA describe un tipo de asignación estándar.

Sintaxis

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;

Miembros

StandardAllocationType

[in] Valor de tipo D3DKMDT_STANDARDALLOCATION_TYPE que identifica el tipo de asignación estándar que se va a describir.

pCreateSharedPrimarySurfaceData

[in] Puntero a una estructura D3DKMDT_SHAREDPRIMARYSURFACEDATA , si StandardAllocationType especifica D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Puntero a una estructura de D3DKMDT_SHADOWSURFACEDATA , si StandardAllocationType especifica D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Puntero a una estructura de D3DKMDT_STAGINGSURFACEDATA , si StandardAllocationType especifica D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Puntero a una estructura de D3DKMDT_GDISURFACEDATA , solo disponible si StandardAllocationType especifica D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Este miembro está disponible a partir de Windows 7.

pCreateVirtualGpuSurfaceData

Puntero a una estructura de D3DKMDT_VIRTUALGPUSURFACEDATA si StandardAllocationType está D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponible a partir de WDDM 2.1.

pCreateFenceStorageData

pAllocationPrivateDriverData

[in/out] Puntero a un bloque de datos privados de asignación que describe el tipo de asignación estándar; de lo contrario, este miembro es NULL. Los datos privados de asignación que devuelve la función DxgkDdiGetStandardAllocationDriverData del controlador de miniporte de pantalla dependen del tipo que solicita el controlador en StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Tamaño, en bytes, de los datos privados de asignación a los que apunta pAllocationPrivateDriverData . Si el controlador establece pAllocationPrivateDriverData en NULL, el controlador debe establecer AllocationPrivateDriverDataSize en el tamaño del búfer que el controlador necesita para describir el tipo de asignación estándar especificado.

Si el controlador no usa datos privados para cada asignación para los tipos de asignaciones estándar, el controlador puede establecer AllocationPrivateDriverDataSize en cero.

pResourcePrivateDriverData

[in/out] Puntero a un bloque de datos privados de recursos que describe el tipo de asignación estándar; de lo contrario, este miembro es NULL. Los datos privados del recurso que devuelve la función DxgkDdiGetStandardAllocationDriverData del controlador de miniporte de pantalla dependen del tipo que solicita el controlador en StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Tamaño, en bytes, de los datos privados del recurso a los que apunta pResourcePrivateDriverData . Si el controlador establece pResourcePrivateDriverData en NULL, el controlador debe establecer ResourcePrivateDriverDataSize en el tamaño del búfer que el controlador necesita para describir el tipo de asignación estándar especificado.

Si el controlador no usa datos privados para cada recurso para los tipos de asignaciones estándar, el controlador puede establecer ResourcePrivateDriverDataSize en cero.

PhysicalAdapterIndex

Comentarios

Si el controlador de minipuerto de pantalla devuelve NULL en los miembros pAllocationPrivateDriverData y pResourcePrivateDriverData , el controlador debe devolver los tamaños de los búferes que el controlador necesita en los miembros AllocationPrivateDriverDataSize y ResourcePrivateDriverDataSize . Sin embargo, el controlador no debe cambiar el contenido de la estructura de asignación estándar en la unión que DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA contiene para obtener los tamaños necesarios de los búferes.

Aunque el controlador puede establecer ResourcePrivateDriverDataSize o AllocationPrivateDriverDataSize en cero, el controlador no puede establecer ambos en cero.