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

Artículo
05/26/2023

La función pfnCreateNewModeInfo devuelve un puntero a una estructura de D3DKMDT_VIDPN_TARGET_MODE que el controlador de minipuerto de pantalla rellena antes de llamar a pfnAddMode.

Sintaxis

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

Parámetros

[in] hVidPnTargetModeSet

Identificador de un objeto establecido en modo de destino VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireTargetModeSet de la interfaz DXGK_VIDPN_INTERFACE .

[out] ppNewVidPnTargetModeInfo

Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_VIDPN_TARGET_MODE asignada por el administrador de VidPN.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	El identificador proporcionado en hVidPnTargetModeSet no era válido.

Comentarios

La función pfnCreateNewModeInfo asigna una estructura D3DKMDT_VIDPN_TARGET_MODE y establece su miembro Id en un identificador recién generado.

Después de llamar a pfnCreateNewModeInfo para obtener una estructura de D3DKMDT_VIDPN_TARGET_MODE, debe realizar una, pero no ambas, de las siguientes acciones:

Rellene el miembro Info de la estructura y pase la estructura a pfnAddMode.
Libere la estructura llamando a pfnReleaseModeInfo.

Al rellenar una estructura de D3DKMDT_VIDPN_TARGET_MODE, tiene la opción de sobrescribir el miembro Id generado y establecido por pfnCreateNewModeInfo. Sin embargo, si sobrescribe el miembro Id de cualquier estructura de D3DKMDT_VIDPN_TARGET_MODE, debe sobrescribir los miembros id de todas las estructuras de D3DKMDT_VIDPN_TARGET_MODE que obtenga de pfnCreateNewModeInfo. A menos que tenga un motivo específico para sobrescribir los miembros id (por ejemplo, realizar el seguimiento de los modos de destino con su propio esquema de numeración), debe dejarlos establecidos por pfnCreateNewModeInfo.

El tipo de datos D3DKMDT_HVIDPNTARGETMODESET se define en D3dkmdt.h.