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

Consulte también

IWICBitmapSource::CopyPixels

IWICDdsFrameDecode