structure D3DKMT_CREATEALLOCATION (d3dkmthk.h)

Article
05/23/2024

La structure D3DKMT_CREATEALLOCATION décrit les paramètres de création d’allocations.

Syntaxe

typedef struct _D3DKMT_CREATEALLOCATION {
  [in]     D3DKMT_HANDLE                hDevice;
  [in/out] D3DKMT_HANDLE                hResource;
  [out]    D3DKMT_HANDLE                hGlobalShare;
  void                         D3DKMT_PTR(
    const VOID          *unnamedParam1,
    pPrivateRuntimeData unnamedParam2
  );
  [in]     UINT                         PrivateRuntimeDataSize;
  union {
    [in]     D3DKMT_CREATESTANDARDALLOCATION *pStandardAllocation;
    [in]     const VOID                      *pPrivateDriverData;
  };
  [in/out] UINT                         PrivateDriverDataSize;
  [in]     UINT                         NumAllocations;
  union {
    [in]     D3DDDI_ALLOCATIONINFO  *pAllocationInfo;
    [in]     D3DDDI_ALLOCATIONINFO2 *pAllocationInfo2;
  };
  [in]     D3DKMT_CREATEALLOCATIONFLAGS Flags;
  void                         D3DKMT_PTR(
    HANDLE                        unnamedParam1,
    hPrivateRuntimeResourceHandle unnamedParam2
  );
} D3DKMT_CREATEALLOCATION;

Membres

[in] hDevice

Handle de l’appareil auquel la ressource ou l’allocation est associée.

[in/out] hResource

Un D3DKMT_HANDLE type de données qui représente un handle en mode noyau pour la ressource associée aux allocations. La valeur dans hResource doit toujours être zéro, sauf si une allocation est ajoutée à une ressource existante, auquel cas hResource contient le handle de ressource.

Lorsque l’indicateur de champ de bits CreateResource est défini dans le membre Flags , le runtime OpenGL génère un handle unique et le transmet au pilote. Lors de la sortie de la fonction D3DKMTCreateAllocation , hResource spécifie le handle que le pilote doit utiliser dans les appels d’exécution OpenGL suivants pour identifier la ressource. Le handle de ressource retourné est spécifique à l’appareil et est valide uniquement lorsqu’il est utilisé avec l’appareil sur lequel il a été créé.

[out] hGlobalShare

Un pilote client en mode utilisateur ne doit pas partager de ressources à l’aide de handles globaux. Le pilote doit définir NtSecuritySharing dans Flags et appeler D3DKMTShareObjects pour obtenir un handle NT. L’utilisation de handles globaux n’est pas sécurisée. N’importe quel processus peut deviner un handle global et ouvrir un objet partagé. Les handles globaux sont pris en charge uniquement pour des raisons de compatibilité avec les anciens runtimes D3D. (Lorsque NtSecuritySharing n’est pas défini, le handle global est retourné dans hGlobalShare. Rien n’empêche une UMD de partager une ressource à l’aide d’un handle global, mais les pilotes ne doivent pas le faire.)

void D3DKMT_PTR( const VOID *unnamedParam1, pPrivateRuntimeData unnamedParam2)

[in] PrivateRuntimeDataSize

Taille, en octets, des données privées vers laquelle pPrivateRuntimeData pointe.

[in] pStandardAllocation

Pointeur vers une structure D3DKMT_CREATESTANDARDALLOCATION qui décrit l’allocation standard à créer.

[in] pPrivateDriverData

Pointeur vers une mémoire tampon qui contient des données privées facultatives dont le pilote miniport d’affichage peut avoir besoin pour créer la ressource ou l’allocation. Le contenu de la mémoire tampon provient généralement de l’ICD et doit être dans un format que le pilote miniport d’affichage peut traiter.

[in/out] PrivateDriverDataSize

Taille, en octets, des données privées vers laquelle pPrivateDriverData pointe.

[in] NumAllocations

Nombre d’éléments dans le tableau spécifié par pAllocationInfo , qui représente le nombre d’allocations à créer. Notez que la création d’une ressource sans allocations initialement associées est valide ; Par conséquent, NumAllocations peut être défini sur 0.

[in] pAllocationInfo

Tableau de structures D3DDDI_ALLOCATIONINFO qui décrivent des propriétés spécifiques pour chaque allocation à créer.

[in] pAllocationInfo2

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

Ce membre est disponible à partir de Windows 7.

[in] Flags

Une structure D3DKMT_CREATEALLOCATIONFLAGS qui identifie les attributs pour la création de l’allocation, dans les indicateurs de champ de bits.

Si vous définissez l’indicateur de champ de bits CreateShared dans Indicateurs, vous devez également définir l’indicateur de champ de bits CreateResource .

void D3DKMT_PTR( HANDLE unnamedParam1, hPrivateRuntimeResourceHandle unnamedParam2)

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
En-tête	d3dkmthk.h (inclure D3dkmthk.h)

Voir aussi

D3DDDI_ALLOCATIONINFO

D3DKMTCreateAllocation

D3DKMT_CREATEALLOCATIONFLAGS

Partager via