SetShapeDmaWritePointer

Establece el puntero de escritura de acceso directo a memoria (DMA).

Sintaxis

HRESULT SetShapeDmaWritePointer(  
         SHAPE_DMA_CONTEXT* context,  
         UINT32 writePointer  
)  

Parámetros

context _Inout_
Tipo: SHAPE_DMA_CONTEXT* Puntero a una estructura SHAPE_DMA_CONTEXT. writePointer
Tipo: UINT32 El valor del puntero de escritura.

Valor devuelto

Tipo: HRESULT Código HRESULT de éxito o de error.

Comentarios

Para calcular el tamaño de un búfer DMA, use la fórmula siguiente:

fullBufferSizeInBytes = 128 * 4 * numChannels * numFrames

Los punteros de lectura y escritura se incrementan de la siguiente manera:

readPointer = (readPointer + 1) % numFrames 

writePointer = (writePointer + 1) % numFrames  

Las direcciones dentro del búfer de audio se calculan de la siguiente manera:

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

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

Puede evitar los comandos DMA bloqueados asegurándose de que el búfer de audio sea lo suficientemente grande y de que los datos se transmitan a intervalos regulares (en relación con el tamaño del búfer). Por ejemplo, si transmite cuatro fotogramas de hardware a la vez, asegúrese de que en el búfer haya algún múltiplo de esos fotogramas (al menos con doble búfer, es decir, ocho fotogramas) para que el hardware pueda escribir por delante del puntero de lectura del título. Como alternativa, podría exigir el vaciado del búfer antes de enviar el siguiente grafo de flujo (consumir, actualizar el puntero de lectura de DMA y, a continuación, enviar el grafo de flujo). Para obtener más detalles, consulte Comandos bloqueados en Información general sobre SHAPE. Puede enviar grafos de flujo para que se procesen como persistentes o no persistentes. Los grafos de flujo persistentes se procesan y, a continuación, permanecen residentes para repetir su procesamiento en el siguiente fotograma después de que los punteros de lectura y escritura hayan avanzado y de que se haya actualizado el resto de la información de contexto.

Requisitos

Encabezado: shapedmacontext.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

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

SetShapeDmaWritePointer

SetShapeDmaWritePointer

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también

​SetShapeDmaWritePointer

​Sintaxis

​Parámetros

​Valor devuelto

​Comentarios

​Requisitos

​Consulte también

SetShapeDmaWritePointer

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también