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

Artículo
02/23/2024

La función pfnAcquireTargetModeSet devuelve un identificador a un objeto de conjunto de modo de destino determinado contenido por un objeto VidPN especificado.

Sintaxis

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

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] VidPnTargetId

Entero que identifica uno de los destinos de vídeo presentes asociados al objeto VidPN.

[out] phVidPnTargetModeSet

Puntero a una variable que recibe un identificador para el objeto de conjunto de modo de destino solicitado.

[out] ppVidPnTargetModeSetInterface

Puntero a una variable que recibe un puntero a una estructura de DXGK_VIDPNTARGETMODESET_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 de modo de destino.

Valor devuelto

La función pfnAcquireTargetModeSet 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_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	El identificador proporcionado en VidPnTargetId no era válido.

Comentarios

El controlador de minipuerto de visualización asigna identificadores de destino VidPN. DxgkDdiQueryChildRelations, implementado por el controlador de miniporte de pantalla, devuelve una matriz de estructuras de DXGK_CHILD_DESCRIPTOR , cada una de las cuales contiene un identificador.

Cuando haya terminado de usar el identificador de objeto set del modo de destino, debe liberar el identificador llamando a pfnReleaseTargetModeSet. Se cuentan los objetos del conjunto de modo de destino, por lo que si adquiere un identificador varias veces, debe liberarlo ese mismo número de veces.

La duración de la estructura DXGK_VIDPNTARGETMODESET_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.

El tipo de datos D3DDDI_VIDEO_PRESENT_TARGET_ID se define en D3dukmdt.h.

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