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 関数は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| 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 | pMonitorSourceModeInfo が指す構造体は、hMonitorSourceModeSet で指定されたモード セットに追加するために作成されませんでした。 |
注釈
pMonitorSourceModeInfo-Preference> がD3DKMDT_MP_PREFERREDと等しい場合、新しく追加されたモードがモード セットの優先モードになります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | PASSIVE_LEVEL |