DXGKDDI_MONITORSOURCEMODESET_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 de monitor especificado, dado el modo actual.
Sintaxis
DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
[in] IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}
Parámetros
[in] hMonitorSourceModeSet
Identificador de un objeto establecido en modo de origen de supervisión. El controlador de minipuerto de pantalla obtuvo este identificador llamando a la función pfnAcquireMonitorSourceModeSet de la interfaz Monitor.
[in] pMonitorSourceModeInfo
Puntero a una estructura de D3DKMDT_MONITOR_SOURCE_MODE que describe el modo actual. El controlador de minipuerto de pantalla obtuvo este puntero llamando a pfnAcquireFirstModeInfo o pfnAcquireNextModeInfo.
[out] ppNextMonitorSourceModeInfo
Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_MONITOR_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_MONITOR_SOURCEMODESET | El identificador proporcionado en hMonitorSourceModeSet no era válido. |
Comentarios
Cuando haya terminado de usar la estructura D3DKMDT_MONITOR_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 de monitor determinado llamando a pfnAcquireFirstModeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextModeInfo.
El tipo de datos D3DKMDT_HMONITORSOURCEMODESET se define en D3dkmdt.h.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |