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) |