Compartir a través de

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

  • Artículo

La función pfnCreateNewModeInfo devuelve un puntero a una estructura de D3DKMDT_VIDPN_TARGET_MODE que el controlador de miniporte 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 miniporte 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 realizó correctamente.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET El identificador proporcionado en hVidPnTargetModeSet no era válido.

Observaciones

La función de pfnCreateNewModeInfo asigna una estructura de D3DKMDT_VIDPN_TARGET_MODE y establece su id. miembro 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:

Al rellenar una estructura de D3DKMDT_VIDPN_TARGET_MODE, tiene la opción de sobrescribir el miembro id. de que generó y estableció pfnCreateNewModeInfo. Sin embargo, si sobrescribe el id. miembro de cualquier estructura de D3DKMDT_VIDPN_TARGET_MODE, debe sobrescribir los miembros de id. de 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 de Id. (por ejemplo, realizar un seguimiento de los modos de destino con su propio esquema de numeración), debe dejarlos tal como se establecen pfnCreateNewModeInfo.

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

pfnAddMode

pfnReleaseModeInfo