structure D3DDDIARG_CREATERESOURCE2 (d3dukmdt.h)

Article
08/07/2023

Contient des informations sur la création d’une ressource. Utilisé par les pilotes d’affichage en mode utilisateur windows WDDM (Windows Display Driver Model) 1.2 et versions ultérieures.

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 pour une surface à échantillon multiple. Si la surface n’est pas plusieurs échantillonnées, cette valeur est D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

Niveau de qualité des exemples de rendu dans une surface à échantillon 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 échantillons (c’est-à-dire, si D3DDDIMULTISAMPLE_NONE est spécifié dans MultisampleType), elle peut toujours avoir un niveau de qualité supérieur à 1 (qui est spécifié en utilisant 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 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 présent vidéo (VidPN) sur laquelle la surface primaire est créée (si la ressource contient une surface primaire).

[in] RefreshRate

Une 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 primaire et si l’indicateur de champ de bits 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 CreateResource2 , 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 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 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 480x640 à 90 degrés (D3DDDI_ROTATION_90). Le pilote doit allouer la surface en mode 640x480 à des fins d’analyse. Lors du rendu sur 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 bit 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 indicateurs de champ binaire dans D3DDDI_RESOURCEFLAGS2 nécessitent que des indicateurs de champ binaire supplémentaires soient également définis.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
En-tête	d3dukmdt.h (inclure D3dukmdt.h, D3dkmddi.h)