D3DDDIARG_CREATERESOURCE structure (d3dukmdt.h)

Article
02/26/2024

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)

Voir aussi

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE