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

Artículo
05/26/2023

La función pfnAddMode agrega un modo de destino VidPN a un objeto de conjunto de modo de destino VidPN especificado.

Sintaxis

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parámetros

[in] hVidPnTargetModeSet

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

[in] pVidPnTargetModeInfo

Puntero a una estructura de D3DKMDT_VIDPN_TARGET_MODE que describe el modo de destino. El controlador de minipuerto de pantalla obtuvo anteriormente esta estructura llamando a pfnCreateNewModeInfo.

Valor devuelto

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

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

Para agregar un modo a un conjunto de modo de destino, el controlador de minipuerto de pantalla realiza los pasos siguientes.

Llame a pfnCreateNewModeInfo para obtener un puntero a una estructura de D3DKMDT_VIDPN_TARGET_MODE . La función pnfCreateNewModeInfo asigna la estructura y rellena el miembro Id con un identificador de modo de destino recién generado.
El miembro Info de la estructura D3DKMDT_VIDPN_TARGET_MODE es una estructura de D3DKMDT_VIDEO_SIGNAL_MODE . Rellene esa estructura con información sobre el modo .
Llame a pfnAddMode para agregar el modo a un conjunto de modos de destino.

El administrador vidPN asigna una estructura de D3DKMDT_VIDPN_TARGET_MODE al llamar a pfnCreateNewModeInfo. Si agrega el modo descrito por esa estructura a un conjunto de modo de destino, no es necesario liberar explícitamente la estructura; pfnAddMode lo libera.

Si obtiene una estructura de D3DKMDT_VIDPN_TARGET_MODE llamando a pfnCreateNewModeInfo y decide no agregar ese modo a un conjunto de modos de destino, debe liberar explícitamente la estructura llamando a pfnReleaseModeInfo.

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