DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO función de devolución de llamada (d3dkmddi.h)
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 miniporte 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 siguiente modo.
Valor devuelto
La función pfnAcquireNextModeInfo 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
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.
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 |