estrutura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artigo
12/21/2023

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

Sintaxe

typedef struct _DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA {
  [in]     D3DKMDT_STANDARDALLOCATION_TYPE StandardAllocationType;
  union {
    [in]     D3DKMDT_SHAREDPRIMARYSURFACEDATA *pCreateSharedPrimarySurfaceData;
    [in]     D3DKMDT_SHADOWSURFACEDATA        *pCreateShadowSurfaceData;
    [in]     D3DKMDT_STAGINGSURFACEDATA       *pCreateStagingSurfaceData;
    [in]     D3DKMDT_GDISURFACEDATA           *pCreateGdiSurfaceData;
             D3DKMDT_VIRTUALGPUSURFACEDATA    *pCreateVirtualGpuSurfaceData;
  };
  [in/out] VOID                            *pAllocationPrivateDriverData;
  [out]    UINT                            AllocationPrivateDriverDataSize;
  [in/out] VOID                            *pResourcePrivateDriverData;
  [out]    UINT                            ResourcePrivateDriverDataSize;
           UINT                            PhysicalAdapterIndex;
} DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA;

Membros

[in] StandardAllocationType

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

[in] pCreateSharedPrimarySurfaceData

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

[in] pCreateShadowSurfaceData

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

[in] pCreateStagingSurfaceData

Um ponteiro para uma estrutura de D3DKMDT_STAGINGSURFACEDATA , se StandardAllocationType especificar D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

[in] pCreateGdiSurfaceData

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

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

pCreateVirtualGpuSurfaceData

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

[in/out] pAllocationPrivateDriverData

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 retornados pela função DxgkDdiGetStandardAllocationDriverData do driver de miniporta dependem do tipo que o driver solicita em StandardAllocationType.

[out] AllocationPrivateDriverDataSize

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.

[in/out] pResourcePrivateDriverData

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 do recurso que a função DxgkDdiGetStandardAllocationDriverData do driver de miniporta de exibição retorna dependem do tipo que o driver solicita em StandardAllocationType.

[out] ResourcePrivateDriverDataSize

O tamanho, em bytes, dos dados privados de 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 exigidos pelo driver 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.