DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure (d3dkmddi.h)

Article
05/23/2024

La structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA décrit un type d’allocation standard.

Syntaxe

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;

Membres

StandardAllocationType

[in] Valeur D3DKMDT_STANDARDALLOCATION_TYPE typée qui identifie le type d’allocation standard à décrire.

pCreateSharedPrimarySurfaceData

[in] Pointeur vers une structure D3DKMDT_SHAREDPRIMARYSURFACEDATA , si StandardAllocationType spécifie D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Pointeur vers une structure D3DKMDT_SHADOWSURFACEDATA , si StandardAllocationType spécifie D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Pointeur vers une structure D3DKMDT_STAGINGSURFACEDATA , si StandardAllocationType spécifie D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Pointeur vers une structure D3DKMDT_GDISURFACEDATA , disponible uniquement si StandardAllocationType spécifie D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Ce membre est disponible à partir de Windows 7.

pCreateVirtualGpuSurfaceData

Pointeur vers une structure D3DKMDT_VIRTUALGPUSURFACEDATA si StandardAllocationType est D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponible à partir de WDDM 2.1.

pCreateFenceStorageData

pAllocationPrivateDriverData

[entrée/sortie] Pointeur vers un bloc de données privées d’allocation qui décrit le type d’allocation standard ; sinon, ce membre est NULL. Les données privées d’allocation retournées par la fonction DxgkDdiGetStandardAllocationDriverData du pilote miniport d’affichage dépendent du type que le pilote demande dans StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Taille, en octets, des données privées d’allocation vers laquelle pAllocationPrivateDriverData pointe. Si le pilote définit pAllocationPrivateDriverData sur NULL, le pilote doit définir AllocationPrivateDriverDataSize sur la taille de la mémoire tampon dont le pilote a besoin pour décrire le type d’allocation standard donné.

Si le pilote n’utilise pas de données privées pour chaque allocation pour les types d’allocations standard, le pilote peut définir AllocationPrivateDriverDataSize sur zéro.

pResourcePrivateDriverData

[entrée/sortie] Pointeur vers un bloc de données privées de ressource qui décrit le type d’allocation standard ; sinon, ce membre est NULL. Les données privées de ressource retournées par la fonction DxgkDdiGetStandardAllocationDriverData du pilote miniport d’affichage dépendent du type que le pilote demande dans StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Taille, en octets, des données privées de la ressource vers laquelle pResourcePrivateDriverData pointe. Si le pilote définit pResourcePrivateDriverData sur NULL, le pilote doit définir ResourcePrivateDriverDataSize sur la taille de la mémoire tampon dont le pilote a besoin pour décrire le type d’allocation standard donné.

Si le pilote n’utilise pas de données privées pour chaque ressource pour les types d’allocations standard, le pilote peut définir ResourcePrivateDriverDataSize sur zéro.

PhysicalAdapterIndex

Remarques

Si le pilote de miniport d’affichage retourne NULL dans les membres pAllocationPrivateDriverData et pResourcePrivateDriverData , le pilote doit retourner les tailles des mémoires tampons requises par le pilote dans les membres AllocationPrivateDriverDataSize et ResourcePrivateDriverDataSize . Toutefois, le pilote ne doit pas modifier le contenu de la structure d’allocation standard dans l’union que DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA contient pour obtenir les tailles requises des mémoires tampons.

Bien que le pilote puisse définir ResourcePrivateDriverDataSize ou AllocationPrivateDriverDataSize sur zéro, le pilote ne peut pas définir les deux sur zéro.