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
監視來源模式集合物件的句柄。 顯示迷你埠驅動程式先前藉由呼叫 Monitor 介面的 pfnAcquireMonitorSourceModeSet 函式來取得此句柄。
[in] pMonitorSourceModeInfo
描述監視來源模式之 D3DKMDT_MONITOR_SOURCE_MODE 結構的指標。 顯示迷你埠驅動程式先前藉由呼叫 pfnCreateNewModeInfo 來取得此結構。
傳回值
pfnAddMode 函式會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
| 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->識別碼中提供的標識碼已用於模式集中的另一個模式。 |
| STATUS_GRAPHICS_RESOURCES_NOT_RELATED | pMonitorSourceModeInfo 所指向的結構不是為了加入 hMonitorSourceModeSet 所指定的模式集而建立的。 |
言論
如果 pMonitorSourceModeInfo->喜好設定 等於D3DKMDT_MP_PREFERRED，則新加入的模式會變成模式集的慣用模式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | PASSIVE_LEVEL |