structure D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Article
02/26/2024

D3D10DDIARG_CREATERESOURCE contient les arguments utilisés par PFND3D10DDI_CREATERESOURCE pour créer une ressource.

Syntaxe

typedef struct D3D10DDIARG_CREATERESOURCE {
  [in]      const D3D10DDI_MIPINFO            *pMipInfoList;
  [in]      const D3D10_DDIARG_SUBRESOURCE_UP *pInitialDataUP;
  [in]      D3D10DDIRESOURCE_TYPE             ResourceDimension;
  [in]      UINT                              Usage;
  [in]      UINT                              BindFlags;
  [in]      UINT                              MapFlags;
  [in]      UINT                              MiscFlags;
  [in]      DXGI_FORMAT                       Format;
  [in]      DXGI_SAMPLE_DESC                  SampleDesc;
  [in]      UINT                              MipLevels;
  [in]      UINT                              ArraySize;
  [in, out] DXGI_DDI_PRIMARY_DESC             *pPrimaryDesc;
} D3D10DDIARG_CREATERESOURCE;

Membres

[in] pMipInfoList

Tableau de structures D3D10DDI_MIPINFO qui contient des dimensions pour les niveaux MIP. Pour les formats de ressources où un seul pixel ou un texel ne peut pas être référencé directement avec une adresse d’octet, les dimensions de la ressource physique sont généralement plus grandes ou égales aux dimensions de texel, afin de répondre aux besoins d’espace nécessaires. Par exemple, pour créer une texture BC1 entièrement mipped, où le niveau le plus détaillé est 8x8, le tableau pMipInfoList est : { 8, 8, 1, 8, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 1 }, { 1, 1, 4, 4, 1 } .

[in] pInitialDataUP

Tableau de structures D3D10_DDIARG_SUBRESOURCE_UP qui fournit des informations d’initialisation pour la liste des sous-ressources de la ressource.

[in] ResourceDimension

Valeur de type D3D10DDIRESOURCE_TYPE qui indique le type de ressource et la dimensionnalité.

[in] Usage

Valeur de type D3D10_DDI_RESOURCE_USAGE qui indique comment la ressource est utilisée.

[in] BindFlags

Or au niveau du bit valide de D3D10_DDI_RESOURCE_BIND_FLAG valeurs qui indique la façon dont la ressource est liée.

[in] MapFlags

Valeur de type D3D10_DDI_MAP qui indique le niveau d’accès à mapper à la ressource.

[in] MiscFlags

Or au niveau du bit valide de D3D10_DDI_RESOURCE_MISC_FLAG valeurs qui indique des informations diverses sur la ressource.

[in] Format

Valeur de type DXGI_FORMAT qui indique le format de pixels de la ressource.

[in] SampleDesc

Valeur de type DXGI_SAMPLE_DESC qui décrit le nombre d’exemples et la qualité de la ressource.

[in] MipLevels

Nombre de niveaux de carte MIP pour la ressource.

[in] ArraySize

Nombre d’éléments de tableau pour une texture 2D ou une texture 1D. ArraySize doit avoir la valeur 6 pour une texture de cube.

À compter de Windows 8, si le pilote doit créer une mémoire tampon d’arrière stéréo, il doit définir ce membre sur la valeur 2.

[in, pPrimaryDesc

Pointeur vers une structure de DXGI_DDI_PRIMARY_DESC qui décrit une ressource utilisée comme ressource primaire.

Le runtime Microsoft Direct3D définit pPrimaryDesc sur une valeur non NULL uniquement si le bit D3D10_DDI_BIND_PRESENT est défini dans le membre BindFlags ; toutefois, même si D3D10_DDI_BIND_PRESENT est défini, le runtime ne définit pas toujours pPrimaryDesc sur non NULL. La définition de pPrimaryDesc sur non NULL indique que le runtime utilisera la ressource créée comme ressource principale (autrement dit, la ressource est analysée à l’écran) et dans des opérations de présentation de style inversé.

Le pilote d’affichage en mode utilisateur peut retourner l’indicateur DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT dans le membre DriverFlags de DXGI_DDI_PRIMARY_DESC pour empêcher le runtime d’effectuer des opérations de présentation de style inversé.

Si pPrimaryDesc a la valeur NULL, le runtime utilise la ressource créée dans les opérations présentes de type copie (transfert de bloc de bits).