structure D3DDDIARG_CREATERESOURCE2 (d3dukmdt.h)

Article
02/06/2025

Contient des informations pour la création d’une ressource. Utilisé par le modèle de pilote d’affichage Windows (WDDM) 1.2 et les pilotes d’affichage en mode utilisateur ultérieur.

Syntaxe

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [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;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

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 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 de la fonction CreateResource2, 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 CreateResource2, 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.

[in] Flags2

Structure D3DDDI_RESOURCEFLAGS2 qui identifie le type de ressources à créer. Notez que certains des indicateurs de champ binaire dans D3DDDI_RESOURCEFLAGS2 nécessitent également que des indicateurs de champ binaire supplémentaires soient définis.