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