D3DDDIARG_CREATERESOURCE structure (d3dukmdt.h)
La structure D3DDDIARG_CREATERESOURCE contient des informations permettant de créer une ressource.
Syntaxe
typedef struct _D3DDDIARG_CREATERESOURCE {
[in] D3DDDIFORMAT Format;
[in] D3DDDI_POOL Pool;
[in] D3DDDIMULTISAMPLE_TYPE MultisampleType;
[in] UINT MultisampleQuality;
[in] const D3DDDI_SURFACEINFO *pSurfList;
[in] UINT SurfCount;
[in] UINT MipLevels;
[in] UINT Fvf;
[in] D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
[in] D3DDDI_RATIONAL RefreshRate;
[in/out] HANDLE hResource;
[in] D3DDDI_RESOURCEFLAGS Flags;
[in] D3DDDI_ROTATION Rotation;
} D3DDDIARG_CREATERESOURCE;
Membres
[in] Format
Valeur de type D3DDDIFORMAT qui indique le format des ressources.
[in] Pool
Valeur de type D3DDDI_POOL qui indique le type de pool de mémoire à partir duquel les ressources sont créées.
[in] MultisampleType
Valeur de type D3DDDIMULTISAMPLE_TYPE qui indique le nombre d’échantillons pour une surface à échantillonner plusieurs. Si la surface n’est pas échantillonné plusieurs fois, cette valeur est D3DDDIMULTISAMPLE_NONE (0).
[in] MultisampleQuality
Niveau de qualité des échantillons de rendu dans une surface à échantillonnage multiple. Le niveau de qualité doit être un nombre compris entre 0 et 7 qui représente un niveau de qualité compris entre 1 et 8, respectivement.
Notez que même si la surface n’est pas échantillonné plusieurs fois (autrement dit, si D3DDDIMULTISAMPLE_NONE est spécifié dans MultisampleType), elle peut toujours avoir un niveau de qualité supérieur à 1 (qui est spécifié à l’aide d’un nombre supérieur à 0).
[in] pSurfList
Tableau de structures D3DDDI_SURFACEINFO pour la liste des surfaces (ou d’autres types de ressources) à créer.
[in] SurfCount
Nombre de ressources dans le tableau spécifié par le membre pSurfList .
[in] MipLevels
Nombre de niveaux de carte MIP pour les ressources.
[in] Fvf
Format FVF pour les mémoires tampons de vertex.
[in] VidPnSourceId
Numéro d’identification de base zéro de la source vidéo présente dans un chemin d’accès d’une topologie de réseau vidéo présent (VidPN) sur laquelle la surface primaire est créée (si la ressource contient une surface primaire).
[in] RefreshRate
Structure D3DDDI_RATIONAL qui spécifie la fréquence d’actualisation avec laquelle la ressource est utilisée. Ce membre s’applique uniquement si la ressource est la surface primaire et que l’indicateur de champ binaire MatchGdiPrimary n’est pas défini dans le membre Indicateurs . En outre, si l’indicateur de champ de bits InterlacedRefresh est défini dans Indicateurs, le pilote d’affichage en mode utilisateur détermine que la fréquence d’actualisation est entrelacée (sinon, progressive).
[in/out] hResource
Handle de la ressource. Lors de l’entrée dans la fonction CreateResource , hResource spécifie le handle que le pilote doit utiliser chaque fois qu’il rappelle le runtime Microsoft Direct3D.
Le pilote génère un handle unique et le transmet au runtime Direct3D. Lors de la sortie de la fonction CreateResource , hResource spécifie le handle que le runtime Direct3D doit utiliser dans les appels de pilotes suivants pour identifier la ressource.
[in] Flags
Structure D3DDDI_RESOURCEFLAGS qui identifie le type de ressources à créer. Notez que certains indicateurs de champ binaire dans D3DDDI_RESOURCEFLAGS nécessitent que des indicateurs de champ binaire supplémentaires soient également définis.
[in] Rotation
Valeur de type D3DDDI_ROTATION qui identifie l’orientation de la ressource.
Par exemple, considérez que le pilote d’affichage en mode utilisateur reçoit une demande de rotation d’une surface de 480 x 640 degrés (D3DDDI_ROTATION_90). Le pilote doit allouer la surface en mode 640x480 à des fins d’analyse. Lors du rendu à la surface, le pilote doit effectuer la rotation de 90 degrés.
Les orientations autres que D3DDDI_ROTATION_IDENTITY sont définies uniquement lorsque l’indicateur de champ binaire principal est également défini dans le membre Indicateurs .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | d3dukmdt.h (include D3dumddi.h, D3dkmddi.h) |