SetShapeDmaReadPointer

Define o ponteiro de leitura de Direct Memory Access (DMA).

Sintaxe

HRESULT SetShapeDmaReadPointer(  
         SHAPE_DMA_CONTEXT* context,  
         UINT32 readPointer  
)  

Parâmetros

context _Inout_
Tipo: SHAPE_DMA_CONTEXT* Ponteiro para uma estrutura SHAPE_DMA_CONTEXT. readPointer
Tipo: UINT32 O valor do ponteiro de leitura, em quadros (blocos de 128 amostras).

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

Para calcular o tamanho de um buffer de DMA, use a seguinte fórmula:

fullBufferSizeInBytes = 128 * 4 * numChannels * numFrames

Os ponteiros de leitura e gravação são incrementados da seguinte forma:

readPointer = (readPointer + 1) % numFrames 

writePointer = (writePointer + 1) % numFrames  

Os endereços dentro do buffer de áudio são calculados da seguinte forma:

readAddress = audioBuffer + (128 * 4 * ((readPointer * numChannels) + channel))   

writeAddress = audioBuffer + (128 * 4 * ((writePointer * numChannels) + channel))  

Você pode evitar comandos de DMA bloqueados garantindo que seu buffer de áudio seja suficientemente grande e que os dados sejam transmitidos em intervalos regulares (relacionados ao tamanho do buffer). Por exemplo, se você estiver transmitindo quatro quadros de hardware por vez, garanta que algum múltiplo desses quadros (pelo menos em buffer duplo com oito quadros) esteja no buffer para que o hardware possa gravar à frente do ponteiro de leitura do título. Como alternativa, você poderia forçar o esvaziamento do buffer antes de enviar o próximo grafo de fluxo (consumir, atualizar o ponteiro de leitura de DMA e, em seguida, enviar o grafo de fluxo). Para obter mais detalhes, consulte Comandos bloqueados em Visão geral do SHAPE. Você pode enviar grafos de fluxo para serem processados como persistentes ou não persistentes. Os grafos de fluxo persistentes são processados e, em seguida, permanecem residentes para repetir o processamento no próximo quadro, depois que os ponteiros de leitura e gravação avançarem e depois que outras informações de contexto forem atualizadas.

Requisitos

Cabeçalho: shapedmacontext.h Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Confira também

ShapeDmaContext

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

SetShapeDmaReadPointer

SetShapeDmaReadPointer

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​SetShapeDmaReadPointer

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

SetShapeDmaReadPointer

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também