ID3D10Device ::CreateTexture1D, méthode (d3d10.h)

Créez un tableau de textures 1D (voir Texture1D).

Syntaxe

HRESULT CreateTexture1D(
  [in]  const D3D10_TEXTURE1D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture1D              **ppTexture1D
);

Paramètres

[in] pDesc

Type : const D3D10_TEXTURE1D_DESC*

Pointeur vers une description de texture 1D (voir D3D10_TEXTURE1D_DESC). Pour créer une ressource sans type qui peut être interprétée au moment de l’exécution dans différents formats compatibles, spécifiez un format sans type dans la description de la texture. Pour générer automatiquement des niveaux mipmap, définissez le nombre de niveaux mipmap sur 0.

[in] pInitialData

Type : const D3D10_SUBRESOURCE_DATA*

Pointeur vers un tableau de descriptions de sous-ressources (voir D3D10_SUBRESOURCE_DATA) ; un pour chaque sous-ressource (classé par index de tableau de texture). Les applications ne peuvent pas spécifier la valeur NULL pour pInitialData lors de la création de ressources IMMUTABLE (voir D3D10_USAGE). Si la ressource est multi-échantillonnée, pInitialData doit avoir la valeur NULL , car les ressources multi-échantillonnées ne peuvent pas être initialisées avec des données lors de leur création.

[out] ppTexture1D

Type : ID3D10Texture1D**

Adresse d’un pointeur vers la texture créée (consultez Interface ID3D10Texture1D). Définissez ce paramètre sur NULL pour valider les autres paramètres d’entrée (la méthode retourne S_FALSE si les autres paramètres d’entrée réussissent la validation).

Valeur retournée

Type : HRESULT

Si la méthode réussit, le code de retour est S_OK. Pour connaître l’échec des codes d’erreur, consultez Codes de retour Direct3D 10 .

Remarques

CreateTexture1D crée une ressource de texture 1D, qui contient un tableau de textures 1D. Le nombre de textures est spécifié dans la description de la texture. Toutes les textures d’une ressource doivent avoir le même format, la même taille et le même nombre de niveaux mipmap.

Toutes les ressources sont constituées d’une ou plusieurs sous-ressources. Pour charger des données dans la texture, les applications peuvent fournir les données initialement dans le cadre de D3D10_SUBRESOURCE_DATA structure pointée par pInitialData, ou utiliser l’une des fonctions de texturing fournies par le SDK.

Configuration requise

Voir aussi

ID3D10Device Interface