DXGKDDI_VIDPN_ACQUIRETARGETMODESET función de devolución de llamada (d3dkmddi.h)
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 miniport 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 establecido en 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 realizó 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. |
Observaciones
El controlador de miniporte de pantalla asigna los identificadores de destino vidPN. DxgkDdiQueryChildRelations, implementado por el controlador de miniporte de pantalla, devuelve una matriz de estructuras 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. Los objetos del conjunto de modo de destino son referencias, 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 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 .
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | PASSIVE_LEVEL |