Función IddCxSwapChainReleaseAndAcquireBuffer2 (iddcx.h)

Artículo
02/26/2024

Un controlador de pantalla indirecto llama a IddCxSwapChainReleaseAndAcquireBuffer2 para liberar el búfer actual en la cadena de intercambio y adquirir uno nuevo. Un controlador que admita adaptadores HDR debe usar IddCxSwapChainReleaseAndAcquireBuffer2 en lugar de IddCxSwapChainReleaseAndAcquireBuffer e IddCxSwapChainReleaseAndAcquireSystemBuffer.

Sintaxis

HRESULT IddCxSwapChainReleaseAndAcquireBuffer2(
  IDDCX_SWAPCHAIN                    SwapChainObject,
  IDARG_IN_RELEASEANDACQUIREBUFFER2  *pInArgs,
  IDARG_OUT_RELEASEANDACQUIREBUFFER2 *pOutArgs
);

Parámetros

SwapChainObject

[in] Objeto de cadena de intercambio pasado anteriormente por el sistema operativo al controlador en una llamada EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN .

pInArgs

[in] Puntero a una estructura de IDARG_IN_RELEASEANDACQUIREBUFFER2 que contiene los argumentos de entrada de la función.

pOutArgs

[out] Puntero a una estructura de IDARG_OUT_RELEASEANDACQUIREBUFFER2 en la que se devuelven los argumentos de salida de la función.

Valor devuelto

IddCxSwapChainReleaseAndAcquireBuffer2 devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error adecuado.

Comentarios

El espacio de color de la superficie pasada en la estructura IDDCX_METADATA2 también se pasa al controlador. Esto se debe a que puede cambiar por fotograma y no coincidir con el espacio de color especificado cuando se confirmó un modo.

Del mismo modo, el formato de píxel de la superficie proporcionada puede cambiar en un marco a fotograma. Por ejemplo, si se confirma un modo HDR en una ruta de acceso, esto no garantiza que cada superficie sea una superficie FP16.

El nivel de blanco para el contenido de SDR también se incluye para aplicarse a los cursores del mouse.

Si IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA se establece en IDDCX_METADATA2::ValidFlags , IDDCX_METADATA2::Hdr10FrameMetaData contiene datos válidos. Estos metadatos pueden ser uno de estos tres tipos:

Nuevos datos que debe usar el controlador.
Indicación de que se deben usar los metadatos predeterminados enviados previamente al controlador en una llamada a EVT_IDD_CX_MONITOR_SET_DEFAULT_HDR_METADATA .
Indica que se deben volver a usar los metadatos que se enviaron anteriormente. Cuando el tipo es predeterminado o no se modifica, los valores de IDDCX_HDR10_FRAME_METADATA::NewMetaData no son válidos.

IddCxSwapChainReleaseAndAcquireBuffer2 también reemplaza a IddCxSwapChainReleaseAndAcquireSystemBuffer. Un controlador que hubiera llamado a IddCxSwapChainReleaseAndAcquireSystemBuffer puede establecer IDARG_IN_RELEASEANDACQUIREBUFFER2::AcquireSystemMemoryBuffer para indicar que necesita IDDCX_METADATA2::SystemBufferInfo rellenado.

Los controladores de la versión 1.10 que no notifican compatibilidad con FP16 todavía pueden llamar a esta función si está disponible en el sistema operativo.

Para obtener más información sobre la compatibilidad con HDR, consulta Actualizaciones de iddCx versión 1.10.

Metadatos HDR remotos

El sistema operativo no pasará metadatos HDR a controladores remotos porque los metadatos HDR del sistema cliente deben usarse, no los generados por el servidor. En el caso de los controladores remotos IDDCX_METADATA2_VALID_FLAGS_HDR10METADATA nunca se establecerá.