DXGKDDI_VIDPNTARGETMODESET_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 destino VidPN especificado, dado el modo actual.

Sintaxis

DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpntargetmodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppNextVidPnTargetModeInfo
)
{...}

Parámetros

[in] hVidPnTargetModeSet

Identificador de un objeto establecido en modo de destino VidPN. El controlador de minipuerto 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 actual. El controlador de minipuerto de pantalla obtuvo previamente este puntero llamando a pfnAcquireFirstModeInfo o pfnAcquireNextModeInfo.

[out] ppNextVidPnTargetModeInfo

Puntero a una variable que recibe un puntero a una estructura D3DKMDT_VIDPN_TARGET_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_TARGETMODESET	El identificador proporcionado en hVidPnTargetModeSet no era válido.

Comentarios

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

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

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