structure D3DDDIARG_OPENRESOURCE (d3dumddi.h)

La structure D3DDDIARG_OPENRESOURCE contient des informations pour l’ouverture d’une ressource partagée.

Syntaxe

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

Membres

[in] NumAllocations

Nombre d’éléments dans le tableau spécifié par pOpenAllocationInfo. NumAllocations représente le nombre d’allocations à ouvrir.

[in] pOpenAllocationInfo

Tableau de structures D3DDDI_OPENALLOCATIONINFO qui décrivent les allocations dans la ressource à ouvrir.

[in] Tableau de structures D3DDDI_OPENALLOCATIONINFO qui décrivent les allocations dans la ressource à ouvrir.

pOpenAllocationInfo2

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

Ce membre est disponible à partir de Windows 7.

[in] hKMResource

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

Ce handle en mode noyau représente une ressource partagée existante qui a été créée par le biais d’un appel à la fonction CreateResource du pilote d’affichage en mode utilisateur.

[in] pPrivateDriverData

Pointeur vers des données privées qui ont été passées au pilote miniport d’affichage lors de la création de la ressource. Ces données sont par ressource et non par allocation, comme les données privées dans la structure de D3DDDI_OPENALLOCATIONINFO de chaque allocation.

[in] PrivateDriverDataSize

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

[in/out] hResource

Handle de la ressource associée aux allocations.

Le pilote d’affichage en mode utilisateur doit enregistrer ce handle et l’utiliser pour identifier la ressource chaque fois que le pilote rappelle dans le runtime Microsoft Direct3D. Le pilote d’affichage en mode utilisateur doit générer un handle unique et le transmettre au runtime Direct3D. Le runtime Direct3D utilise ce handle dans les appels de pilotes pour identifier la ressource.

[in] Rotation

Valeur de type D3DDDI_ROTATION qui identifie l’orientation de la ressource principale partagée.

Lorsque la ressource principale est utilisée avec un appareil plein écran et qu’elle fait l’objet d’une rotation, le pilote peut être amené à créer des allocations intermédiaires pour gérer l’appareil en plein écran. L’indicateur de champ de bits Fullscreen est défini dans le membre Flags pour indiquer que la ressource principale est utilisée avec un appareil en plein écran.

[in] Flags

Une structure D3DDDI_OPENRESOURCEFLAGS qui identifie le type de ressource à ouvrir.

Remarques

Les indicateurs de champ de bits Primary et SharedResource sont définis dans le membre Flags de la structure D3DDDIARG_CREATERESOURCE dans un appel à la fonction CreateResource pour créer une ressource primaire partagée.

Configuration requise

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

Voir aussi

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource