DXGKDDI_VIDPN_CREATENEWTARGETMODESET función de devolución de llamada (d3dkmddi.h)

Artículo
05/26/2023

La función pfnCreateNewTargetModeSet crea un nuevo objeto de conjunto de modo de destino dentro de un objeto VidPN especificado.

Sintaxis

DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;

NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}

Parámetros

[in] hVidPn

Identificador de un objeto VidPN. El administrador de VidPN previamente proporcionó este identificador al controlador de minipuerto de pantalla llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

Entero que identifica uno de los destinos de presentación de vídeo asociados al objeto VidPN.

[out] phNewVidPnTargetModeSet

Puntero a una variable que recibe un identificador para el objeto de conjunto de modo de destino recién creado.

[out] ppVidPnTargetModeSetInterace

Puntero a una variable que recibe un puntero a una estructura DXGK_VIDPNTARGETMODESET_INTERFACE . La estructura contiene punteros a funciones a las que el controlador de minipuerto de pantalla puede llamar para inspeccionar y modificar el objeto de conjunto de modo de destino.

Valor devuelto

La función pfnCreateNewTargetModeSet devuelve uno de los siguientes valores:

Código devuelto	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_VIDPN	El identificador proporcionado en hVidPn no era válido.
STATUS_NO_MEMORY	El administrador vidPN no pudo asignar la memoria necesaria para crear el nuevo objeto de conjunto de modo de destino.

Comentarios

Para asignar un nuevo modo de destino establecido en un destino determinado en una implementación de VidPN, realice los pasos siguientes:

Llame a pfnCreateNewTargetModeSet para obtener un identificador de un nuevo objeto de conjunto de modo de destino. Ese objeto de conjunto de modo de destino pertenece a un objeto VidPN determinado que especifique.
Use las funciones de la estructura de DXGK_VIDPNTARGETMODESET_INTERFACE para agregar modos al objeto de conjunto de modo de destino.
Llame a pfnAssignTargetModeSet para asignar el nuevo modo de destino establecido en un destino determinado.

Si obtiene un identificador llamando a pfnCreateNewTargetModeSet y, a continuación, pasa ese identificador a pfnAssignTargetModeSet, no es necesario liberar el identificador llamando a pfnReleaseTargetModeSet.

Si obtiene un identificador llamando a pfnCreateNewTargetModeSet y decide no asignar el nuevo modo de destino establecido en un destino, debe liberar el identificador recién obtenido llamando a pfnReleaseTargetModeSet.

La duración de la estructura de DXGK_VIDPNTARGETEMODESET_INTERFACE devuelta en ppVidPnTargetModeSetInterface es propiedad del sistema operativo. Con este esquema de propiedad, el sistema operativo puede cambiar a implementaciones más recientes en tiempo de ejecución sin interrumpir a los clientes de la interfaz.

Los tipos de datos D3DKMDT_HVIDPN y D3DKMDT_HVIDPNTARGETMODESET se definen en D3dkmdt.h.