Función D3DXLoadVolumeFromMemory
Carga un volumen de la memoria.
Sintaxis
HRESULT D3DXLoadVolumeFromMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcMemory,
_In_ D3DFORMAT SrcFormat,
_In_ UINT SrcRowPitch,
_In_ UINT SrcSlicePitch,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
Parámetros
-
pDestVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Puntero a una interfaz IDirect3DVolume9 . Especifica el volumen 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.
-
pDestBox [in]
-
Tipo: const D3DBOX*
Puntero a una estructura D3DBOX . Especifica el cuadro de destino. Establezca este parámetro en NULL para especificar todo el volumen.
-
pSrcMemory [in]
-
Tipo: LPCVOID
Puntero a la esquina superior izquierda del volumen de origen en memoria.
-
SrcFormat [in]
-
Tipo: D3DFORMAT
Miembro del tipo enumerado D3DFORMAT , el formato de píxel del volumen de origen.
-
SrcRowPitch [in]
-
Tipo: UINT
Tono de la imagen de origen, en bytes. Para formatos DXT (formatos de textura comprimidos), este número debe representar el tamaño de una fila de celdas, en bytes.
-
SrcSlicePitch [in]
-
Tipo: UINT
Tono de la imagen de origen, en bytes. Para formatos DXT (formatos de textura comprimidos), este número debe representar el tamaño de un segmento de celdas, en bytes.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntero a una estructura PALETTEENTRY , la paleta de origen de 256 colores o NULL.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Puntero a una estructura D3DBOX . Especifica el cuadro de origen. NULL no es un valor válido para este parámetro.
-
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 opacos. Por lo tanto, para negro opaco, el valor sería igual a 0xFF000000.
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
Escribir en una superficie que no sea de nivel cero de la textura del volumen no hará que se actualice el rectángulo sucio. Si se llama a D3DXLoadVolumeFromMemory y la textura aún no estaba sucia (esto es poco probable en escenarios de uso normales), la aplicación debe llamar explícitamente a IDirect3DVolumeTexture9::AddDirtyBox en la textura del volumen.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también