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 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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluya D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |