estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artigo
11/11/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 digitado D3DKMDT_STANDARDALLOCATION_TYPEque identifica o tipo de alocação padrão a ser descrito.

pCreateSharedPrimarySurfaceData

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

pCreateShadowSurfaceData

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

pCreateStagingSurfaceData

[in] Um ponteiro para uma estrutura de 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 de D3DKMDT_VIRTUALGPUSURFACEDATA se StandardAllocationType estiver D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponível a partir do WDDM 2.1.

pCreateFenceStorageData

Ponteiro para uma estrutura de D3DKMDT_FENCESTORAGESURFACEDATA se StandardAllocationType estiver D3DKMDT_STANDARDALLOCATION_FENCESTORAGE. Disponível a partir do WDDM 3.2.

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 é NULL. Os dados privados de alocação que a função do driver de miniporto de exibição (KMD's) DxgkDdiGetStandardAllocationDriverData retorna depende do tipo que o driver solicita noStandardAllocationType .

AllocationPrivateDriverDataSize

[out] O tamanho, em bytes, dos dados privados de alocação que pAllocationPrivateDriverData aponta. Se o driver definir pAllocationPrivateDriverData como NULL, o driver deverá definir AllocationPrivateDriverDataSize para 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ção 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 é NULL. Os dados privados de recurso que a função DxgkDdiGetGetStandardAllocationDriverData do driver de exibição retorna dependem do tipo que o driver solicita em StandardAllocationType.

ResourcePrivateDriverDataSize

[out] O tamanho, em bytes, dos dados privados de recurso que pResourcePrivateDriverData aponta. Se o driver definir pResourcePrivateDriverData como NULL, o driver deverá definir ResourcePrivateDriverDataSize para 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

[in] O índice do adaptador físico em uma configuração LDA em que o armazenamento será residente.

Observações

tipos de alocação padrão são alocações que devem ser criadas no modo kernel sem comunicação do driver de exibição no modo de usuário.

Se o KMD (driver de miniporto de exibição) no modo kernel retornar NULL no pAllocationPrivateDriverData e membro do pResourcePrivateDriverData, ele deve retornar os tamanhos dos buffers necessários no AllocationPrivateDriverDataSize e membros do ResourcePrivateDriverDataSize. No entanto, o KMD 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 KMD possa definir ResourcePrivateDriverDataSize ou AllocationPrivateDriverDataSize como zero, ele não pode definir ambos como zero.