DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO回调函数 （d3dkmddi.h）

pfnAcquirePreferredModeInfo 在指定的监视源模式集对象中返回首选模式的描述符。

语法

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

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

参数

[in] hMonitorSourceModeSet

监视源模式集对象的句柄。 显示微型端口驱动程序以前通过调用 Monitor 接口的 pfnAcquireMonitorSourceModeSet 函数来获取此句柄。

[out] ppFirstMonitorSourceModeInfo

指向接收指向 D3DKMDT_MONITOR_SOURCE_MODE 结构的指针的变量的指针。 该结构包含有关首选监视器源模式的各种信息，包括其 ID 和视频信号。

返回值

pfnAcquirePreferredModeInfo 函数返回以下值之一。

返回代码	描述
STATUS_SUCCESS	该函数已成功返回首选模式的描述符。
STATIS_GRAPHICS_NO_PREFERRED_MODE	函数成功，但指定的监视器源模式集没有首选模式。
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	hMonitorSourceModeSet 中提供的句柄无效。

言论

使用完 D3DKMDT_MONITOR_SOURCE_MODE 结构后，必须通过调用 pfnReleaseModeInfo释放结构。

D3DKMDT_HMONITORSOURCEMODESET数据类型在 D3dkmdt.h中定义。

要求

要求	价值
最低支持的客户端	Windows Vista
目标平台	桌面
标头	d3dkmddi.h （包括 D3dkmddi.h）
IRQL	PASSIVE_LEVEL