D3D11DDIARG_CREATERESOURCE structure (d3d10umddi.h)

Article
02/22/2024

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 seul pixel ou texel ne peut pas être référencé directement avec une adresse d’octet, les dimensions de la ressource physique sont généralement supérieures 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 mappée, où le niveau le plus détaillé est 8x8, le tableau pMipInfoList est : { { 8, 8, 1, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 1 }, { 1, 1, 4, 1, 4, 1 } }

[in] pInitialDataUP

Tableau de structures D3D10_DDIARG_SUBRESOURCE_UP qui fournit des informations d’initialisation pour la liste de 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 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

Ou au niveau du bit valide de valeurs de type D3D10_DDI_RESOURCE_MISC_FLAG qui indique diverses informations 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 carte 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 d’arrière-mémoire stéréo, il doit définir le membre ArraySize de la structure D3D11DDIARG_CREATERESOURCE sur la valeur 2.

[in, pPrimaryDesc

Pointeur vers une structure de 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 ressource principale (autrement dit, la ressource est analysée à l’affichage) et dans les 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 en mode inversé.

Si pPrimaryDesc est défini sur NULL, le runtime utilise la ressource créée dans ; opérations de présentation de type copy (transfert de bloc binaire).

[in] ByteStride

Taille, en octets, d’une ligne de balayage à la ligne de balayage 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 case activée pas que D3D11DDI_MINOR_HEADER_VERSION >= 3 avant d’accéder à ce membre de structure, il ne doit accéder à ce membre que lorsque l’indicateur D3D11_DDI_BIND_DECODER est défini dans le membre BindFlags.

TextureLayout