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 |