structure D3DDDIARG_CREATERESOURCE (d3dukmdt.h)
La structure D3DDDIARG_CREATERESOURCE contient des informations pour la création d’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 D3DDDIFORMAT-typée qui indique le format des ressources.
[in] Pool
Valeur D3DDDI_POOL-typée qui indique le type de pool de mémoire à partir duquel les ressources sont créées.
[in] MultisampleType
Valeur D3DDDIMULTISAMPLE_TYPE-typée qui indique le nombre d’échantillons d’une surface à plusieurs échantillons. Si la surface n’est pas multiple échantillonné, cette valeur est D3DDDIMULTISAMPLE_NONE (0).
[in] MultisampleQuality
Niveau de qualité des échantillons de rendu dans une surface à plusieurs échantillons. 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 échantillons (autrement dit, si D3DDDIMULTISAMPLE_NONE est spécifiée dans MultisampleType) elle peut toujours avoir un niveau de qualité supérieur à 1 (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 MIP-map 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 vidéo présente source dans un chemin d’accès d’une topologie de réseau présent vidéo (VidPN) sur laquelle la surface primaire est créée (si la ressource contient une surface primaire).
[in] RefreshRate
Structure D3DDDI_RATIONAL qui spécifie le taux d’actualisation avec lequel la ressource est utilisée. Ce membre s’applique uniquement si la ressource est la surface principale et que l’indicateur de champ binaire matchGdiPrimary n’est pas défini dans le membre Indicateurs. En outre, si l’indicateur InterlacedRefresh bit-field est défini dans Indicateurs, le pilote d’affichage en mode utilisateur détermine que le taux d’actualisation est entrelacé (sinon, progressif).
[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 revient au 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 également que des indicateurs de champ binaire supplémentaires soient définis.
[in] Rotation
Valeur D3DDDI_ROTATION-typée qui identifie l’orientation de la ressource.
Par exemple, considérez que le pilote d’affichage en mode utilisateur reçoit une demande pour qu’une surface de 480 x 640 soit pivotée de 90 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 de principal principal est également défini dans le membre Indicateurs.
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 | d3dukmdt.h (include D3dumddi.h, D3dkmddi.h) |