D3D11_MAPPED_SUBRESOURCE structure (d3d11.h)
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.
- 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 |