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

Artículo
05/26/2023

La función pfnCreateNewSourceModeSet crea un nuevo objeto de conjunto de modo de origen dentro de un objeto VidPN especificado.

Sintaxis

DXGKDDI_VIDPN_CREATENEWSOURCEMODESET DxgkddiVidpnCreatenewsourcemodeset;

NTSTATUS DxgkddiVidpnCreatenewsourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phNewVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parámetros

[in] hVidPn

Identificador de un objeto VidPN. El administrador vidPN proporcionó anteriormente este identificador al controlador de miniporte para mostrar llamando a DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

Entero que identifica uno de los orígenes de vídeo asociados al objeto VidPN.

[out] phNewVidPnSourceModeSet

Puntero a una variable que recibe un identificador para el objeto establecido en modo de origen recién creado.

[out] ppVidPnSourceModeSetInterface

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

Valor devuelto

La función pfnCreateNewSourceModeSet 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 origen.

Comentarios

Para asignar un nuevo modo de origen establecido en un origen determinado en un VidPN, realice los pasos siguientes:

Llame a pfnCreateNewSourceModeSet para obtener un identificador para un nuevo objeto de conjunto de modo de origen. Ese objeto de conjunto de modo de origen pertenece a un objeto VidPN determinado que especifique.
Use las funciones de la interfaz DXGK_VIDPNSOURCEMODESET_INTERFACE para agregar modos al objeto de conjunto de modo de origen.
Llame a pfnAssignSourceModeSet para asignar el nuevo modo de origen establecido en un origen determinado.

Si obtiene un identificador llamando a pfnCreateNewSourceModeSet y, a continuación, pasa ese identificador a pfnAssignSourceModeSet, no es necesario liberar el identificador llamando a pfnReleaseSourceModeSet.

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

La duración de la estructura DXGK_VIDPNSOURCEMODESET_INTERFACE devuelta en ppVidPnSourceModeSetInterface 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_HVIDPNSOURCEMODESET se definen en D3dkmdt.h.