D3DXLoadSurfaceFromResource fonction)
Charge une surface à partir d’une ressource.
Syntaxe
HRESULT D3DXLoadSurfaceFromResource(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_Inout_ D3DXIMAGE_INFO *pSrcInfo
);
Paramètres
-
pDestSurface [ dans]
-
Type : LPDIRECT3DSURFACE9
Pointeur vers une interface IDirect3DSurface9 . Spécifie la surface de destination, qui reçoit l’image.
-
pDestPalette [ dans]
-
Type : const PaletteEntry *
Pointeur vers une structure PaletteEntry , la palette de destination de 256 couleurs ou null.
-
pDestRect [ dans]
-
Type : const Rect *
Pointeur vers une structure Rect . Spécifie le rectangle de destination. Affectez la valeur null à ce paramètre pour spécifier la surface entière.
-
hSrcModule [ dans]
-
Type : HMODULE
Handle vers le module dans lequel se trouve la ressource, ou null pour le module associé à l’image que le système d’exploitation a utilisé pour créer le processus actuel.
-
pSrcResource [ dans]
-
Type : LPCTSTR
Pointeur vers une chaîne qui spécifie le nom de la ressource. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, le type de données String est résolu en LPCSTR. Consultez la section Notes.
-
pSrcRect [ dans]
-
Type : const Rect *
Pointeur vers une structure Rect . Spécifie le rectangle source. Affectez la valeur null à ce paramètre pour spécifier la totalité de l’image.
-
Filtre [ dans]
-
Type : DWORD
Combinaison d’un ou de plusieurs _ filtres D3DX contrôlant la façon dont l’image est filtrée. La spécification _ de la valeur D3DX par défaut pour ce paramètre revient à spécifier la valeur de filtre du _ triangle de filtre D3DX _ | _ _ .
-
ColorKey [ dans]
-
Type : D3DCOLOR
Valeur D3DCOLOR à remplacer par le noir transparent, ou 0 pour désactiver le ColorKey. Il s’agit toujours d’une couleur ARVB de 32 bits, indépendante du format d’image source. Alpha est significatif et doit généralement être défini sur FF pour les clés de couleur opaque donc, pour le noir opaque, la valeur est égale à 0xFF000000.
-
pSrcInfo [ in, out]
-
Type : D3DXIMAGE _ info*
Pointeur vers une structure d' _ informations D3DXIMAGE à remplir avec une description des données dans le fichier image source, ou null.
Valeur de retour
Type : HRESULT
Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des valeurs suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé.
Notes
Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXLoadSurfaceFromResourceW. Dans le cas contraire, l’appel de fonction est résolu en D3DXLoadSurfaceFromResourceA, car les chaînes ANSI sont utilisées.
La ressource en cours de chargement doit être de type RT _ bitmap ou RT _ RCDATA. Le type de ressource RT _ RCDATA est utilisé pour charger des formats autres que des bitmaps (tels que. TGA, .jpg et. DDS).
Cette fonction gère la conversion vers et à partir des formats de texture compressés.
L’écriture sur une surface non-niveau zéro n’entraîne pas la mise à jour du rectangle de modification. Si D3DXLoadSurfaceFromFile est appelé et que la surface n’était pas encore modifiée (ce qui est peu probable dans les scénarios d’utilisation normale), l’application doit appeler explicitement AddDirtyRect sur l’aire.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|