D3DDDICB_ALLOCATE structure (d3dumddi.h)

Article
08/07/2023

La structure D3DDDICB_ALLOCATE contient des informations pour l’allocation de mémoire.

Syntaxe

typedef struct _D3DDDICB_ALLOCATE {
  [in]  const VOID            *pPrivateDriverData;
  [in]  UINT                  PrivateDriverDataSize;
  [in]  HANDLE                hResource;
  [out] D3DKMT_HANDLE         hKMResource;
  [in]  UINT                  NumAllocations;
  union {
    [in]  D3DDDI_ALLOCATIONINFO  *pAllocationInfo;
    [in]  D3DDDI_ALLOCATIONINFO2 *pAllocationInfo2;
  };
  [in]  D3DDDI_ALLOCATIONINFO *pAllocationInfo;
} D3DDDICB_ALLOCATE;

Membres

[in] pPrivateDriverData

Pointeur vers des données privées, qui est passé au pilote de miniport d’affichage. Ces données sont par ressource et non par allocation. Si des allocations sont attachées à une ressource existante, les données actuelles doivent remplacer les anciennes données.

[in] PrivateDriverDataSize

Taille, en octets, des données privées pointées par pPrivateDriverData.

[in] hResource

Handle de la ressource associée aux allocations.

Lorsque le pilote d’affichage en mode utilisateur appelle la fonction pfnAllocateCb , le pilote doit affecter la valeur reçue du membre hResource de la structure D3DDDIARG_CREATERESOURCE dans un appel à CreateResource, ou le paramètre hRTResource dans un appel à CreateResource(D3D10) ou CreateResource(D3D11). Il doit affecter la valeur pour associer les allocations à la ressource, ou affecter NULL pour associer les allocations à l’appareil. Le pilote doit affecter une valeur non NULL pour les allocations créées en réponse à des ressources partagées. Les ressources partagées peuvent résulter d’appels CreateResource avec l’indicateur de champ binaire SharedResource défini dans le membre Indicateurs de D3DDDIARG_CREATERESOURCE. Ils peuvent également résulter d’appels CreateResource(D3D10) ou CreateResource(D3D11), avec la valeur D3D10_DDI_RESOURCE_MISC_SHARED définie dans le membre MiscFlags de D3D10DDIARG_CREATERESOURCE ou D3D11DDIARG_CREATERESOURCE.

Le runtime Microsoft Direct3D doit utiliser ce handle dans les appels de pilotes pour identifier la ressource.

[out] hKMResource

Un D3DKMT_HANDLE type de données qui représente un handle en mode noyau pour la ressource associée aux allocations.

Le runtime Direct3D crée et retourne un handle de ressource en mode noyau uniquement si le pilote d’affichage en mode utilisateur définit le membre hResource de D3DDDICB_ALLOCATE sur le handle de ressource du runtime en mode utilisateur qui a été reçu du membre hResource de la structure D3DDDIARG_CREATERESOURCE . Ce handle est reçu dans un appel à CreateResource, ou à partir du paramètre hResource dans un appel à CreateResource(D3D10) ou CreateResource(D3D11).

Le runtime Direct3D génère un handle unique et le transmet au pilote d’affichage en mode utilisateur. Le pilote d’affichage en mode utilisateur peut insérer le handle de ressource en mode noyau dans le flux de commandes pour une utilisation ultérieure par le pilote miniport d’affichage.

[in] NumAllocations

Nombre d’éléments dans le tableau dans pAllocationInfo, qui représente le nombre d’allocations à allouer.

[in] pAllocationInfo

Tableau de structures D3DDDI_ALLOCATIONINFO qui décrivent les allocations à allouer.

[in] Tableau de structures D3DDDI_ALLOCATIONINFO qui décrivent les allocations à allouer.

[in] pAllocationInfo2

Ce membre est réservé et doit être défini sur zéro.

Ce membre est disponible à partir de Windows 7.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	d3dumddi.h (inclure D3dumddi.h)