Función D3DXLoadSurfaceFromResource

Carga una superficie desde un recurso.

Sintaxis

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
);

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.

hSrcModule [in]

Tipo: HMODULE

Controle el módulo donde se encuentra el recurso o NULL para el módulo asociado a la imagen que el sistema operativo usó para crear el proceso actual.

pSrcResource [in]

Tipo: LPCTSTR

Puntero a una cadena que especifica el nombre del recurso. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos de cadena se resuelve en LPCSTR. Vea la sección Comentarios.

pSrcRect [in]

Tipo: const RECT*

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

Filtro [in]

Tipo: DWORD

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

ColorKey [in]

Tipo: D3DCOLOR

Valor D3DCOLOR para 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. El 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.

pSrcInfo [in, out]

Tipo: D3DXIMAGE_INFO*

Puntero a una estructura de D3DXIMAGE_INFO que se va a rellenar con una descripción de los datos del archivo de imagen de origen o NULL.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es 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

La configuración del compilador también determina la versión de la función. Si se define Unicode, la llamada de función se resuelve en D3DXLoadSurfaceFromResourceW. De lo contrario, la llamada de función se resuelve en D3DXLoadSurfaceFromResourceA porque se usan cadenas ANSI.

El recurso que se carga debe ser de tipo RT_BITMAP o RT_RCDATA. El tipo de recurso RT_RCDATA se usa para cargar formatos distintos de los mapas de bits (como .tga, .jpg y .dds).

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 D3DXLoadSurfaceFromFile 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