Función D3DXLoadSurfaceFromMemory

Carga una superficie de la memoria.

Sintaxis

HRESULT D3DXLoadSurfaceFromMemory(
  _In_       LPDIRECT3DSURFACE9 pDestSurface,
  _In_ const PALETTEENTRY       *pDestPalette,
  _In_ const RECT               *pDestRect,
  _In_       LPCVOID            pSrcMemory,
  _In_       D3DFORMAT          SrcFormat,
  _In_       UINT               SrcPitch,
  _In_ const PALETTEENTRY       *pSrcPalette,
  _In_ const RECT               *pSrcRect,
  _In_       DWORD              Filter,
  _In_       D3DCOLOR           ColorKey
);

Parámetros

pDestSurface [in]

Tipo: LPDIRECT3DSURFACE9

Puntero a una interfaz IDirect3DSurface9 . Especifica la superficie de destino, que recibe la imagen.

pDestPalette [in]

Tipo: const PALETTEENTRY*

Puntero a una estructura PALETTEENTRY , la paleta de destino de 256 colores o NULL.

pDestRect [in]

Tipo: const RECT*

Puntero a una estructura RECT . Especifica el rectángulo de destino. Establezca este parámetro en NULL para especificar toda la superficie.

pSrcMemory [in]

Tipo: LPCVOID

Puntero a la esquina superior izquierda de la imagen de origen en memoria.

SrcFormat [in]

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , el formato de píxel de la imagen de origen.

SrcPitch [in]

Tipo: UINT

Tono de la imagen de origen, en bytes. En el caso de los formatos DXT, este número debe representar el ancho de una fila de celdas, en bytes.

pSrcPalette [in]

Tipo: const PALETTEENTRY*

Puntero a una estructura PALETTEENTRY , la paleta de origen de 256 colores o NULL.

pSrcRect [in]

Tipo: const RECT*

Puntero a una estructura RECT . Especifica las dimensiones de la imagen de origen en memoria. Este valor no puede ser NULL.

Filtro [in]

Tipo: DWORD

Combinación de uno o varios D3DX_FILTER controlar cómo se filtra la imagen. Especificar D3DX_DEFAULT para este parámetro es equivalente a especificar D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Tipo: D3DCOLOR

Valor D3DCOLOR que se va a reemplazar por negro transparente o 0 para deshabilitar la clave de color. Siempre es un color ARGB de 32 bits, independientemente del formato de imagen de origen. Alfa es significativo y normalmente debe establecerse en FF para las teclas de color opaco. Por lo tanto, para negro opaco, el valor sería igual a 0xFF000000.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes valores: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Comentarios

Esta función controla la conversión a y desde formatos de textura comprimidos.

Escribir en una superficie que no sea de nivel cero no hará que se actualice el rectángulo sucio. Si se llama a D3DXLoadSurfaceFromMemory y la superficie aún no estaba sucia (esto es poco probable en escenarios de uso normales), la aplicación debe llamar explícitamente a AddDirtyRect en la superficie.

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9