structure DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Article
11/11/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

Pointeur vers une structure D3DKMDT_FENCESTORAGESURFACEDATA si StandardAllocationType est D3DKMDT_STANDARDALLOCATION_FENCESTORAGE. Disponible à partir de WDDM 3.2.

pAllocationPrivateDriverData

[in/out] Pointeur vers un bloc de données privées d’allocation qui décrit le type d’allocation standard ; sinon, ce membre a la valeur NULL. Les données privées d’allocation que la fonction KMD (miniport driver’s) d’affichage DxgkDdiGetStandardAllocationDriverData renvoie dépend du type que le pilote demande dans StandardAllocationType.

AllocationPrivateDriverDataSize

[out] La taille, en octets, des données privées d’allocation qui pAllocationPrivateDriverData pointe vers. Si le pilote définit pAllocationPrivateDriverData sur NULL, le pilote doit définir AllocationPrivateDriverDataSize à 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 allocation pour les types d’allocations standard, le pilote peut définir AllocationPrivateDriverDataSize sur zéro.

pResourcePrivateDriverData

[in/out] Pointeur vers un bloc de données privées de ressources qui décrit le type d’allocation standard ; sinon, ce membre a la valeur NULL. Les données privées de ressources que la fonction DxgkDdiGetStandardAllocationDriverData du pilote d 'affichage affichent dépend 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 à 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

[in] Index de l’adaptateur physique dans une configuration LDA où le stockage sera résident.

Remarques

types d’allocation standard sont des allocations qui doivent être créées en mode noyau sans communication à partir du pilote d’affichage en mode utilisateur.

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

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