D3D11_MAPPED_SUBRESOURCE structure (d3d11.h)

Article
02/24/2024

Fournit l’accès aux données de sous-ressources.

Syntaxe

typedef struct D3D11_MAPPED_SUBRESOURCE {
  void *pData;
  UINT RowPitch;
  UINT DepthPitch;
} D3D11_MAPPED_SUBRESOURCE;

Membres

pData

Type : void*

Pointeur vers les données. Lorsque ID3D11DeviceContext ::Map fournit le pointeur, le runtime s’assure que le pointeur a un alignement spécifique, en fonction des niveaux de fonctionnalités suivants :

Pour les D3D_FEATURE_LEVEL_10_0 et les versions ultérieures, le pointeur est aligné sur 16 octets.
Pour une valeur inférieure à D3D_FEATURE_LEVEL_10_0, le pointeur est aligné sur 4 octets.

RowPitch

Type : UINT

Hauteur de ligne, largeur ou taille physique (en octets) des données.

DepthPitch

Type : UINT

Hauteur de profondeur, largeur ou taille physique (en octets) des données.

Remarques

Cette structure est utilisée dans un appel à ID3D11DeviceContext ::Map.

Les valeurs de ces membres vous indiquent la quantité de données que vous pouvez afficher :

pData pointe vers la ligne 0 et la tranche de profondeur 0.
RowPitch contient la valeur que le runtime ajoute à pData pour passer d’une ligne à une autre, où chaque ligne contient plusieurs pixels.
DepthPitch contient la valeur que le runtime ajoute à pData pour passer d’une tranche de profondeur à une tranche de profondeur, où chaque tranche de profondeur contient plusieurs lignes.

Lorsque RowPitch et DepthPitch ne conviennent pas au type de ressource, le runtime peut définir leurs valeurs sur 0. Par conséquent, n’utilisez pas ces valeurs pour autre chose que l’itération sur les lignes et la profondeur. Voici quelques exemples :

Pour Buffer et Texture1D, le runtime affecte des valeurs qui ne sont pas 0 à RowPitch et DepthPitch. Par exemple, si une mémoire tampon contient 8 octets, le runtime affecte à RowPitch et DepthPitch des valeurs supérieures ou égales à 8.
Pour Texture2D, le runtime affecte toujours une valeur qui n’est pas 0 à DepthPitch, en supposant que le champ n’est pas utilisé.

Note Le runtime peut affecter des valeurs à RowPitch et DepthPitch qui sont plus grandes que prévu, car il peut y avoir un remplissage entre les lignes et la profondeur.

Configuration requise

Condition requise	Valeur
En-tête	d3d11.h

Voir aussi

Structures de ressources

Partager via