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

Artículo
02/23/2024

La función pfnAcquireNextModeInfo devuelve un descriptor del siguiente modo en un conjunto de modo de origen VidPN especificado, dado el modo actual.

Sintaxis

DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}

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 .

[in] pVidPnSourceModeInfo

Puntero a una estructura D3DKMDT_VIDPN_SOURCE_MODE que describe el modo actual. El controlador de minipuerto de pantalla obtuvo previamente este puntero llamando a pfnAcquireFirstModeInfo o pfnAcquireNextModeInfo.

[out] ppNextVidPnSourceModeInfo

Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_VIDPN_SOURCE_MODE que describe el modo siguiente.

Valor devuelto

La función pfnAcquireNextModeInfo 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

Cuando haya terminado de usar la estructura D3DKMDT_VIDPN_SOURCE_MODE , debe liberar la estructura llamando a pfnReleaseModeInfo.

Puede enumerar todos los modos que pertenecen a un objeto de conjunto de modo de origen VidPN llamando a pfnAcquireFirstModeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextModeInfo.

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