DXGKDDI_VIDPNSOURCEMODESET_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 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 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.
[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 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_SOURCEMODESET | El identificador proporcionado en hVidPnSourceModeSet no era válido. |
Observaciones
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 establecido 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.
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 |