Partager via


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

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

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

[in] pPrivateDriverData

Pointeur vers des données privées transmises 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 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 revient 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 D3DDDI_ROTATION-typée qui identifie l’orientation de la ressource primaire partagée.

Lorsque la ressource principale est utilisée avec un appareil plein écran et qu’elle est pivotée, le pilote peut être tenu de créer des allocations intermédiaires pour gérer l’appareil plein écran. L’indicateur de champ de bits plein écran est défini dans le membre indicateurs de pour indiquer que la ressource principale est utilisée avec un appareil plein écran.

[in] Flags

Structure D3DDDI_OPENRESOURCEFLAGS qui identifie le type de ressource à ouvrir.

Remarques

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

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête d3dumddi.h (include D3dumddi.h)

Voir aussi

createResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource