estructura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artículo
11/11/2024

La estructura 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_TYPEque 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, disponible solo 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 es D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponible a partir de WDDM 2.1.

pCreateFenceStorageData

Puntero a una estructura de D3DKMDT_FENCESTORAGESURFACEDATA si StandardAllocationType es D3DKMDT_STANDARDALLOCATION_FENCESTORAGE. Disponible a partir de WDDM 3.2.

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 la función del controlador de miniporte de visualización (KMD) DxgkDdiGetStandardAllocationDriverData depende del tipo que solicita el controlador en StandardAllocationType.

AllocationPrivateDriverDataSize

[out] El tamaño, en bytes, de los datos privados de asignación a los que pAllocationPrivateDriverData apunta. Si el controlador establece pAllocationPrivateDriverData en NULL, el controlador debe establecer AllocationPrivateDriverDataSize al 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 del controlador de miniporte para mostrar DxgkDdiGetStandardAllocationDriverData depende del tipo que solicita el controlador en StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Tamaño, en bytes, de los datos privados del recurso a los que pResourcePrivateDriverData apunta. Si el controlador establece pResourcePrivateDriverData en NULL, el controlador debe establecer ResourcePrivateDriverDataSize al 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

[in] Índice del adaptador físico en una configuración de LDA donde el almacenamiento estará residente.

Observaciones

los tipos de asignación estándar son asignaciones que se deben crear en modo kernel sin comunicación desde el controlador de visualización en modo de usuario.

Si el controlador de miniporte para mostrar en modo kernel (KMD) devuelve NULL en el pAllocationPrivateDriverData y miembro pResourcePrivateDriverData, debe devolver los tamaños de los búferes que requiere en el AllocationPrivateDriverDataSize y miembros resourcePrivateDriverDataSize. Sin embargo, el KMD 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 KMD puede establecer ResourcePrivateDriverDataSize o AllocationPrivateDriverDataSize en cero, no puede establecer ambos en cero.