structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Article
02/26/2024

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

Syntaxe

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;

Membres

[in] StandardAllocationType

Valeur de type D3DKMDT_STANDARDALLOCATION_TYPE qui identifie le type d’allocation standard à décrire.

[in] pCreateSharedPrimarySurfaceData

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

[in] pCreateShadowSurfaceData

Pointeur vers une structure de D3DKMDT_SHADOWSURFACEDATA , si StandardAllocationType spécifie D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

[in] pCreateStagingSurfaceData

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

[in] pCreateGdiSurfaceData

Pointeur vers une structure de 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.

[in/out] pAllocationPrivateDriverData

Pointeur vers un bloc de données privées d’allocation qui décrit le type d’allocation standard ; dans le cas contraire, ce membre a la valeur NULL. Les données privées d’allocation que la fonction DxgkDdiGetStandardAllocationDriverData du pilote miniport d’affichage retourne dépend du type que le pilote demande dans StandardAllocationType.

[out] AllocationPrivateDriverDataSize

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.

[in/out] pResourcePrivateDriverData

Pointeur vers un bloc de données privées de ressources qui décrit le type d’allocation standard ; dans le cas contraire, ce membre a la valeur NULL. Les données privées de ressource retournées par la fonction DxgkDdiGetStandardAllocationDriverData du pilote miniport dépendent du type que le pilote demande dans StandardAllocationType.

[out] ResourcePrivateDriverDataSize

Taille, en octets, des données privées de 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 requise par le pilote 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 dont le pilote a besoin 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 contient DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 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.