Método IWICDdsFrameDecode::CopyBlocks (wincodec.h)
Solicita datos de píxeles, ya que se almacenan de forma nativa en el archivo DDS.
Sintaxis
HRESULT CopyBlocks(
[in] const WICRect *prcBoundsInBlocks,
[in] UINT cbStride,
[in] UINT cbBufferSize,
[out] BYTE *pbBuffer
);
Parámetros
[in] prcBoundsInBlocks
Tipo: const WICRect*
Rectángulo que se va a copiar desde el origen. Un valor NULL especifica toda la textura.
Si la textura usa un DXGI_FORMAT comprimido en bloque, todos los valores del rectángulo se expresan en el número de bloques, no en píxeles.
[in] cbStride
Tipo: UINT
Intervalo, en bytes, del búfer de destino. Representa el número de bytes del puntero del búfer a la siguiente fila de datos. Si la textura usa un DXGI_FORMAT comprimido por bloques, se define una "fila de datos" como una fila de bloques que contiene varias líneas de examen de píxeles.
[in] cbBufferSize
Tipo: UINT
Tamaño, en bytes, del búfer de destino.
[out] pbBuffer
Tipo: BYTE*
Puntero al búfer de destino.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si la textura no usa un DXGI_FORMAT comprimido en bloque, este método se comporta de forma similar a IWICBitmapSource::CopyPixels. Sin embargo, no realiza ninguna conversión de formato de píxel y, en su lugar, genera los datos sin procesar del archivo DDS.
Si la textura usa un DXGI_FORMAT comprimido en bloque, este método copia los datos del bloque directamente en el búfer proporcionado. En este caso, el parámetro prcBoundsInBlocks se define en bloques, no en píxeles. Para determinar si este es el caso, llame a GetFormatInfo y lea el miembro DxgiFormat de la estructura WICDdsFormatInfo devuelta.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincodec.h |
| Library | Windowscodecs.lib |
| Archivo DLL | Windowscodecs.dll |