Método IWICDdsFrameDecode::CopyBlocks (wincodec.h)
Solicita dados de pixel, pois eles são armazenados nativamente no arquivo DDS.
Sintaxe
HRESULT CopyBlocks(
[in] const WICRect *prcBoundsInBlocks,
[in] UINT cbStride,
[in] UINT cbBufferSize,
[out] BYTE *pbBuffer
);
Parâmetros
[in] prcBoundsInBlocks
Tipo: const WICRect*
O retângulo a ser copiado da origem. Um valor NULL especifica toda a textura.
Se a textura usar um DXGI_FORMAT compactado por blocos, todos os valores do retângulo serão expressos em número de blocos, não em pixels.
[in] cbStride
Tipo: UINT
O passo a passo, em bytes, do buffer de destino. Isso representa o número de bytes do ponteiro do buffer para a próxima linha de dados. Se a textura usar um DXGI_FORMAT compactado em bloco, uma "linha de dados" será definida como uma linha de blocos que contém várias linhas de verificação de pixel.
[in] cbBufferSize
Tipo: UINT
O tamanho, em bytes, do buffer de destino.
[out] pbBuffer
Tipo: BYTE*
Um ponteiro para o buffer de destino.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Se a textura não usar um DXGI_FORMAT compactado por blocos, esse método se comportará de forma semelhante a IWICBitmapSource::CopyPixels. No entanto, ele não executa nenhuma conversão de formato de pixel e, em vez disso, produz os dados brutos do arquivo DDS.
Se a textura usar um DXGI_FORMAT compactado em bloco, esse método copiará os dados de bloco diretamente para o buffer fornecido. Nesse caso, o parâmetro prcBoundsInBlocks é definido em blocos, não em pixels. Para determinar se esse é o caso, chame GetFormatInfo e leia o membro DxgiFormat da estrutura WICDdsFormatInfo retornada.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | wincodec.h |
Biblioteca | Windowscodecs.lib |
DLL | Windowscodecs.dll |