Compartir a través de

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

  • Artículo

La función pfnAddMode agrega un modo de destino VidPN a un objeto establecido 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 previamente este identificador llamando a la función pfnAcquireTargetModeSet de la interfaz DXGK_VIDPN_INTERFACE.

[in] pVidPnTargetModeInfo

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

Valor devuelto

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

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

Observaciones

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

  1. 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 id. miembro con un identificador de modo de destino recién generado.
  2. El miembro Info de la estructura D3DKMDT_VIDPN_TARGET_MODE es una estructura D3DKMDT_VIDEO_SIGNAL_MODE. Rellene esa estructura con información sobre el modo .
  3. Llame a pfnAddMode para agregar el modo a un conjunto de modos de destino.
El administrador de 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.

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

Consulte también

D3DKMDT_VIDPN_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo