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

La función pfnCreateNewModeInfo devuelve un puntero a una estructura D3DKMDT_VIDPN_SOURCE_MODE que el controlador de miniporte para mostrar se rellena antes de llamar a pfnAddMode.

Sintaxis

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Parámetros

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

Puntero a una variable que recibe un puntero a una estructura D3DKMDT_VIDPN_SOURCE_MODE asignada por el administrador 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_SOURCEMODESET	El identificador proporcionado en hVidPnSourceModeSet no era válido.

Observaciones

La función pfnCreateNewModeInfo asigna una estructura de D3DKMDT_VIDPN_SOURCE_MODE, establece su miembro Id en un identificador recién generado y establece su miembro Type en D3DKMDT_RMT_UNINITIALIZED.

Después de llamar a pfnCreateNewModeInfo para obtener una estructura de D3DKMDT_VIDPN_SOURCE_MODE, debe hacer una, pero no ambas, de las siguientes:

• Rellene la estructura y pásela a pfnAddMode.
• Libere la estructura llamando a pfnReleaseModeInfo.

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

El tipo de datos D3DKMDT_HVIDPNSOURCEMODESET 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_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo