DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO función de devolución de llamada (d3dkmddi.h)

PfnAcquirePreferredModeInfo devuelve un descriptor del modo preferido en un objeto establecido en modo de origen de monitor especificado.

Sintaxis

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

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.

[out] ppFirstMonitorSourceModeInfo

Puntero a una variable que recibe un puntero a una estructura D3DKMDT_MONITOR_SOURCE_MODE . La estructura contiene una variedad de información sobre el modo de origen de monitor preferido, incluido su identificador y señal de vídeo.

Valor devuelto

La función pfnAcquirePreferredModeInfo devuelve uno de los valores siguientes.

Código devuelto	Descripción
STATUS_SUCCESS	La función devolvió correctamente un descriptor del modo preferido.
STATIS_GRAPHICS_NO_PREFERRED_MODE	La función se realizó correctamente, pero el modo de origen del monitor especificado no tiene un modo preferido.
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.

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