DXGKDDI_VIDPN_CREATENEWTARGETMODESET función de devolución de llamada (d3dkmddi.h)
La función pfnCreateNewTargetModeSet crea un nuevo objeto establecido en 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 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] phNewVidPnTargetModeSet
Puntero a una variable que recibe un identificador del objeto establecido en modo de destino recién creado.
[out] ppVidPnTargetModeSetInterace
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 pfnCreateNewTargetModeSet 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_NO_MEMORY | El administrador vidPN no pudo asignar la memoria necesaria para crear el nuevo objeto de conjunto de modo de destino. |
Observaciones
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 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 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 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 los clientes de la interfaz.
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 |