DXGKDDI_MONITORSOURCEMODESET_ADDMODE回呼函式 (d3dkmddi.h)

  • 發行項

pfnAddMode 函式會將監視來源模式新增至指定的監視來源模式集物件。

語法

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

參數

[in] hMonitorSourceModeSet

監視來源模式集合物件的句柄。 顯示迷你埠驅動程式先前已透過呼叫監視器介面的 pfnAcquireMonitorSourceModeSet 函式來取得此句柄。

[in] pMonitorSourceModeInfo

描述監視來源模式之 D3DKMDT_MONITOR_SOURCE_MODE 結構的指標。 顯示迷你埠驅動程式先前藉由呼叫 pfnCreateNewModeInfo 來取得此結構。

傳回值

pfnAddMode 函式會傳回下列其中一個值。

傳回碼 Description
STATUS_SUCCESS 此函數已成功。
STATUS_NO_MEMORY 函式失敗，因為它無法配置足夠的記憶體。
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE pMonitorSourceModeInfo 中提供的資訊無效。
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET hMonitorSourceModeSet 中提供的句柄無效。
STATUS_GRAPHICS_INVALID_FREQUENCY pMonitorSourceModeInfo 中提供的頻率信息無效。
STATUS_GRAPHICS_INVALID_ACTIVE_REGION pMonitorSourceModeInfo 中提供的作用中區域無效。
STATUS_GRAPHICS_INVALID_TOTAL_REGION pMonitorSourceModeInfo 中提供的總區域無效。
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET 此模式集已經包含與 pMonitorSourceModeInfo 中提供的模式完全相同的模式。
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE pMonitorSourceModeInfo-Id> 中提供的標識碼已經在模式集中用於另一個模式。
STATUS_GRAPHICS_RESOURCES_NOT_RELATED 除了 hMonitorSourceModeSet 所指定的模式集之外，並未建立 pMonitorSourceModeInfo 所指向的結構。

備註

如果 pMonitorSourceModeInfo-Preference> 等於D3DKMDT_MP_PREFERRED，則新新增的模式會變成模式集的慣用模式。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

另請參閱

pfnCreateNewModeInfo