structure D3D11DDIARG_CREATERESOURCE (d3d10umddi.h)

Article
02/06/2025

La structure D3D11DDIARG_CREATERESOURCE décrit une ressource à créer.

Syntaxe

typedef struct D3D11DDIARG_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;
  [in]      UINT                                 ByteStride;
  [in]      D3D11_1DDI_VIDEO_DECODER_BUFFER_TYPE DecoderBufferType;
            D3DWDDM2_0DDI_TEXTURE_LAYOUT         TextureLayout;
} D3D11DDIARG_CREATERESOURCE;

Membres

[in] pMipInfoList

Tableau de structures D3D10DDI_MIPINFO qui contient des dimensions pour les niveaux MIP. Pour les formats de ressources où un pixel ou un texel unique 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 texel, afin de répondre aux exigences d’espace nécessaires. Par exemple, pour créer une texture BC1 entièrement mipée, où le niveau le plus détaillé est 8x8, le tableau pMipInfoList est le suivant : { 8, 8, 1, 8, 1 }, { 4, 4, 1, 4, 1 }, { 2, 2, 1, 4, 1, 4, 1, 4, 1 }, { 1, 1, 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 des valeurs de type D3D10_DDI_RESOURCE_BIND_FLAG 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 des valeurs de type D3D10_DDI_RESOURCE_MISC_FLAG qui indique des informations diverses sur la ressource.

[in] Format

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

[in] SampleDesc

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

[in] MipLevels

Nombre de niveaux de mappage MIP pour la ressource.

[in] ArraySize

Nombre d’éléments de tableau pour une texture 2D ou une texture 1D. ArraySize doit être défini sur 6 pour une texture de cube.

À compter de Windows 8, si le pilote doit créer une mémoire tampon de retour stéréo, il doit définir le ArraySize membre de la structure D3D11DDIARG_CREATERESOURCE sur la valeur 2.

[in, pPrimaryDesc

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

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 principal (autrement dit, la ressource est analysée à l’affichage) et dans les opérations présentes de style inverse.

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

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

[in] ByteStride

Taille, en octets, d’une ligne d’analyse à la ligne d’analyse suivante dans la surface.

[in] DecoderBufferType

Valeur de type D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE qui indique le type de mémoire tampon utilisé par le décodeur vidéo.

Si le pilote ne vérifie pas que D3D11DDI_MINOR_HEADER_VERSION >= 3 avant d’accéder à ce membre de structure, il doit accéder à ce membre uniquement lorsque l’indicateur de D3D11_DDI_BIND_DECODER est défini dans le BindFlags membre.

TextureLayout