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

Artículo
02/23/2024

La función pfnCreateNewModeInfo devuelve un puntero a una estructura de D3DKMDT_VIDPN_SOURCE_MODE que el controlador de miniporte de pantalla 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 de conjunto de modo de origen VidPN. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnAcquireSourceModeSet de la interfaz DXGK_VIDPN_INTERFACE .

[out] ppNewVidPnSourceModeInfo

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

Comentarios

La función pfnCreateNewModeInfo asigna una estructura D3DKMDT_VIDPN_SOURCE_MODE , establece su miembro Id en un identificador recién generado y establece su miembro Typeen 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 generado y establecido por pfnCreateNewModeInfo. Sin embargo, si sobrescribe el miembro Id de cualquier estructura de D3DKMDT_VIDPN_SOURCE_MODE, debe sobrescribir los miembros Id 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 (por ejemplo, realizar el seguimiento de los modos de origen con su propio esquema de numeración), debe dejarlos establecidos por pfnCreateNewModeInfo.

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