CLBufferRead

Lê um buffer de OpenCL em uma array e retorna o número de elementos de leitura.

uint  CLBufferRead(
   int          buffer,                    // Um manipulador para o buffer OpenCL
   const void&  data[],                    // Uma array de valores
   uint         buffer_offset=0,           // Um deslocamento no buffer OpenCL em bites, 0 por padrão
   uint         data_offset=0,             // Um deslocamento na array de elementos, 0 por padrão
   uint         data_count=WHOLE_ARRAY     // O número de valores a partir da buffer de leitura, todo o buffer por defeito
   );

Parâmetros

buffer

[in]   Um manipulador do buffer OpenCL.

data[]

[in]  Um array para receber os valores do buffer OpenCL. Passado por referência.

buffer_offset

[in]  Um deslocamento no buffer OpenCL em bites, a partir da qual se inicia a leitura. Por padrão, a leitura começa com o início do buffer.

data_offset

[in]  O índice do primeiro elemento array para escrever os valores de buffer OpenCL. Por padrão, a escrita dos valores lidos em um array começa a partir do índice zero.

data_count

[in]  O número de valores que devem ser lidos. Todo o buffer OpenCL é lido por padrão.

Valor do Retorno

O número de elementos de leitura. 0 (zero) é devolvido em caso de erro. Para obter informações sobre o erro, utilize a função GetLastError().

Observação

Para arrays unidimensionais, o número do elemento, em que a escrita de dados num buffer de OpenCL inicia, é calculado tendo em conta os sinalizadores AS_SERIES.

Um array de duas ou mais dimensões é apresentado como unidimensional. Neste caso, data_offset é o número de elementos que devem ser ignorados na apresentação, e não o número de elementos na primeira dimensão.