estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artigo
05/23/2024

A estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA descreve um tipo de alocação padrão.

Sintaxe

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;

Membros

StandardAllocationType

[in] Um valor de tipo D3DKMDT_STANDARDALLOCATION_TYPE que identifica o tipo de alocação padrão a ser descrito.

pCreateSharedPrimarySurfaceData

[in] Um ponteiro para uma estrutura D3DKMDT_SHAREDPRIMARYSURFACEDATA , se StandardAllocationType especificar D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Um ponteiro para uma estrutura D3DKMDT_SHADOWSURFACEDATA , se StandardAllocationType especificar D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Um ponteiro para uma estrutura D3DKMDT_STAGINGSURFACEDATA , se StandardAllocationType especificar D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Um ponteiro para uma estrutura de D3DKMDT_GDISURFACEDATA , disponível somente se StandardAllocationType especificar D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Este membro está disponível a partir do Windows 7.

pCreateVirtualGpuSurfaceData

Ponteiro para uma estrutura D3DKMDT_VIRTUALGPUSURFACEDATA se StandardAllocationType for D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponível a partir do WDDM 2.1.

pCreateFenceStorageData

pAllocationPrivateDriverData

[entrada/saída] Um ponteiro para um bloco de dados privados de alocação que descreve o tipo de alocação padrão; caso contrário, esse membro será NULL. Os dados privados de alocação que a função DxgkDdiGetStandardAllocationDriverData do driver de miniporta de exibição retorna dependem do tipo que o driver solicita em StandardAllocationType.

AllocationPrivateDriverDataSize

[out] O tamanho, em bytes, dos dados privados de alocação para os quais pAllocationPrivateDriverData aponta. Se o driver definir pAllocationPrivateDriverData como NULL, o driver deverá definir AllocationPrivateDriverDataSize como o tamanho do buffer necessário para descrever o tipo de alocação padrão fornecido.

Se o driver não usar dados privados para cada alocação para tipos de alocações padrão, o driver poderá definir AllocationPrivateDriverDataSize como zero.

pResourcePrivateDriverData

[entrada/saída] Um ponteiro para um bloco de dados privados de recurso que descreve o tipo de alocação padrão; caso contrário, esse membro será NULL. Os dados privados do recurso que a função DxgkDdiGetStandardAllocationDriverData do driver de miniporta de exibição retorna dependem do tipo que o driver solicita em StandardAllocationType.

ResourcePrivateDriverDataSize

[out] O tamanho, em bytes, dos dados privados do recurso para os quais pResourcePrivateDriverData aponta. Se o driver definir pResourcePrivateDriverData como NULL, o driver deverá definir ResourcePrivateDriverDataSize como o tamanho do buffer necessário para descrever o tipo de alocação padrão fornecido.

Se o driver não usar dados privados para cada recurso para tipos de alocações padrão, o driver poderá definir ResourcePrivateDriverDataSize como zero.

PhysicalAdapterIndex

Comentários

Se o driver de miniporto de exibição retornar NULL nos membros pAllocationPrivateDriverData e pResourcePrivateDriverData , o driver deverá retornar os tamanhos dos buffers que o driver requer nos membros AllocationPrivateDriverDataSize e ResourcePrivateDriverDataSize . No entanto, o driver não deve alterar o conteúdo da estrutura de alocação padrão na união que DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA contém para obter os tamanhos necessários dos buffers.

Embora o driver possa definir ResourcePrivateDriverDataSize ou AllocationPrivateDriverDataSize como zero, o driver não pode definir ambos como zero.