D3D10DDI_MAPPED_SUBRESOURCE structure (d3d10umddi.h)

La structure D3D10DDI_MAPPED_SUBRESOURCE décrit une sous-ressource à laquelle le pilote est mappé via un appel à la fonction ResourceMap du pilote.

Syntaxe

typedef struct D3D10DDI_MAPPED_SUBRESOURCE {
  [out] void *pData;
  [out] UINT RowPitch;
  [out] UINT DepthPitch;
} D3D10DDI_MAPPED_SUBRESOURCE;

Membres

[out] pData

Pointeur vers une mémoire tampon qui contient le contenu de la sous-ressource.

[out] RowPitch

Tangage, largeur ou taille physique (en octets) des données.

[out] DepthPitch

Tangage, largeur ou taille physique (en octets) des données.

Remarques

Le membre pData pointe vers la ligne 0 et la tranche 0.

Le membre RowPitch est la valeur ajoutée à pData pour passer d’une ligne à l’autre. Chaque ligne doit contenir plusieurs pixels.

Le membre DepthPitch est la valeur ajoutée à pData pour passer d’une tranche de profondeur à une tranche de profondeur. Chaque tranche de profondeur doit contenir plusieurs lignes.

Il n’est pas recommandé d’affecter une valeur de zéro aux membres RowPitch et DepthPitch .

Pour éviter des valeurs nulles pour ces membres, il est utile de considérer toutes les ressources comme étant tridimensionnelles, comme dans ces deux exemples :

  • Si l’attribut de ressource est Buffer ou Texture1D et contient 8 octets, les valeurs appropriées pour RowPitch et DepthPitch sont 8 ou plus.
  • Si l’attribut de ressource est Texture2d, même si DepthPitch n’est pas utilisé, la valeur zéro ne doit pas être affectée à DepthPitch .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

ResourceMap