DXGKARGCB_NOTIFY_INTERRUPT_DATA 構造体 (d3dkmddi.h)
DXGKARGCB_NOTIFY_INTERRUPT_DATA構造体には、DXGKCB_NOTIFY_INTERRUPTコールバック関数の割り込み通知情報が含まれています。
構文
typedef struct _DXGKARGCB_NOTIFY_INTERRUPT_DATA {
DXGK_INTERRUPT_TYPE InterruptType;
union {
struct {
UINT SubmissionFenceId;
UINT NodeOrdinal;
UINT EngineOrdinal;
} DmaCompleted;
struct {
UINT PreemptionFenceId;
UINT LastCompletedFenceId;
UINT NodeOrdinal;
UINT EngineOrdinal;
} DmaPreempted;
struct {
UINT FaultedFenceId;
NTSTATUS Status;
UINT NodeOrdinal;
UINT EngineOrdinal;
} DmaFaulted;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
PHYSICAL_ADDRESS PhysicalAddress;
UINT PhysicalAdapterMask;
} CrtcVsync;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
} DisplayOnlyVsync;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
UINT PhysicalAdapterMask;
UINT MultiPlaneOverlayVsyncInfoCount;
DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO *pMultiPlaneOverlayVsyncInfo;
} CrtcVsyncWithMultiPlaneOverlay;
DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS DisplayOnlyPresentProgress;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
DXGK_MIRACAST_CHUNK_INFO ChunkInfo;
PVOID pPrivateDriverData;
UINT PrivateDataDriverSize;
NTSTATUS Status;
} MiracastEncodeChunkCompleted;
struct {
UINT FaultedFenceId;
UINT64 FaultedPrimitiveAPISequenceNumber;
DXGK_RENDER_PIPELINE_STAGE FaultedPipelineStage;
UINT FaultedBindTableEntry;
DXGK_PAGE_FAULT_FLAGS PageFaultFlags;
D3DGPU_VIRTUAL_ADDRESS FaultedVirtualAddress;
UINT NodeOrdinal;
UINT EngineOrdinal;
UINT PageTableLevel;
DXGK_FAULT_ERROR_CODE FaultErrorCode;
HANDLE FaultedProcessHandle;
} DmaPageFaulted;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
UINT PhysicalAdapterMask;
UINT MultiPlaneOverlayVsyncInfoCount;
DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 *pMultiPlaneOverlayVsyncInfo;
ULONGLONG GpuFrequency;
ULONGLONG GpuClockCounter;
} CrtcVsyncWithMultiPlaneOverlay2;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
} MonitoredFenceSignaled;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
UINT64 ContextSwitchFence;
} HwContextListSwitchCompleted;
struct {
UINT64 FaultedFenceId;
D3DGPU_VIRTUAL_ADDRESS FaultedVirtualAddress;
UINT64 FaultedPrimitiveAPISequenceNumber;
union {
HANDLE FaultedHwQueue;
HANDLE FaultedHwContext;
HANDLE FaultedProcessHandle;
};
UINT NodeOrdinal;
UINT EngineOrdinal;
DXGK_RENDER_PIPELINE_STAGE FaultedPipelineStage;
UINT FaultedBindTableEntry;
DXGK_PAGE_FAULT_FLAGS PageFaultFlags;
UINT PageTableLevel;
DXGK_FAULT_ERROR_CODE FaultErrorCode;
} HwQueuePageFaulted;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
UINT NotificationID;
} PeriodicMonitoredFenceSignaled;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
} SchedulingLogInterrupt;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
} GpuEngineTimeout;
struct {
HANDLE hContext;
UINT64 ContextSuspendFence;
} SuspendContextCompleted;
struct {
D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
UINT PhysicalAdapterMask;
UINT MultiPlaneOverlayVsyncInfoCount;
DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 *pMultiPlaneOverlayVsyncInfo;
ULONGLONG GpuFrequency;
ULONGLONG GpuClockCounter;
} CrtcVsyncWithMultiPlaneOverlay3;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
UINT SignaledNativeFenceCount;
HANDLE *pSignaledNativeFenceArray;
HANDLE hHWQueue;
} NativeFenceSignaled;
struct {
UINT NodeOrdinal;
UINT EngineOrdinal;
DXGK_ENGINE_STATE NewState;
} EngineStateChange;
struct {
UINT Reserved[16];
} Reserved;
};
DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS Flags;
} DXGKARGCB_NOTIFY_INTERRUPT_DATA;
メンバー
InterruptType
ディスプレイ ミニポート ドライバーが GPU スケジューラに通知する割り込みの種類を示すDXGK_INTERRUPT_TYPE型指定された値。
DmaCompleted
InterruptType がDXGK_INTERRUPT_DMA_COMPLETEDされるときに使用される構造体。
DmaCompleted.SubmissionFenceId
完了したコマンドの DMA バッファー フェンス識別子。 この識別子は、ドライバーの DXGKDDI_SUBMITCOMMAND 関数の呼び出し中に、完了した最新の DMA バッファーに割り当てられます。
DmaCompleted.NodeOrdinal
通知を生成するノードの 0 から始まるインデックス。
DmaCompleted.EngineOrdinal
NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクに含まれていないグラフィックス アダプターの場合は、常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。
DmaPreempted
InterruptType がDXGK_INTERRUPT_DMA_PREEMPTEDされるときに使用される構造体。
DmaPreempted.PreemptionFenceId
割り込み要求の送信識別子。
DmaPreempted.LastCompletedFenceId
プリエンプション前の最後に完了したコマンドの送信識別子。
DmaPreempted.NodeOrdinal
通知を生成するノードの 0 から始まるインデックス。
DmaPreempted.EngineOrdinal
NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクの一部ではないグラフィックス アダプターの場合は、 常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。 GPU スケジューラは、プリエンプション要求と LastCompletedFenceId が指定する送信の間に、ハードウェアがすべてのコマンドを割り込んだと判断します。
DmaFaulted
InterruptType がDXGK_INTERRUPT_DMA_FAULTEDされるときに使用される構造体。
DmaFaulted.FaultedFenceId
問題のあるコマンドの識別子。
DmaFaulted.Status
問題のあるコマンドの状態。
DmaFaulted.NodeOrdinal
通知を生成するノードの 0 から始まるインデックス。
DmaFaulted.EngineOrdinal
NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクに含まれていないグラフィックス アダプターの場合は、常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。
CrtcVsync
InterruptType がDXGK_INTERRUPT_CRTC_VSYNCされるときに使用される構造体。
CrtcVsync.VidPnTargetId
ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。
CrtcVsync.PhysicalAddress
表示バッファーの物理アドレス。 モニターの可視性がオフの場合でも、オペレーティング システムでは NULL 以外の物理アドレスが想定されます。 このアドレスは、可視性がオンの場合にピクセル パイプラインが読み取る物理アドレスに設定する必要があります。
CrtcVsync.PhysicalAdapterMask
垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。
DisplayOnlyVsync
InterruptType がDXGK_INTERRUPT_DISPLAYONLY_VSYNCされるときに使用される構造体。 Windows 8 以降でサポートされています。
DisplayOnlyVsync.VidPnTargetId
表示専用ドライバーの場合、ビデオ 存在ネットワーク (VidPN) トポロジのパス内のビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。 Windows 8 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay
InterruptType がDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAYされるときに使用される構造体。 マルチプレーン オーバーレイをサポートするディスプレイ ミニポート ドライバーの VSync 通知を提供します。 Windows 8 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay.VidPnTargetId
ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。 Windows 8 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay.PhysicalAdapterMask
垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows 8 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay.MultiPlaneOverlayVsyncInfoCount
表示できるオーバーレイ平面の数。 Windows 8 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay.pMultiPlaneOverlayVsyncInfo
VSync 間隔中に表示するオーバーレイ プレーンを指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO 構造体へのポインター。 Windows 8 以降でサポートされています。
DisplayOnlyPresentProgress
カーネル モードの表示専用ドライバー (KMDOD) の現在の操作の進行状況を提供する DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS 構造体。 InterruptType がDXGK_INTERRUPT_DISPLAYONLY_PRESENT_PROGRESSされるときに使用されます。 Windows 8 以降でサポートされています。
MiracastEncodeChunkCompleted
InterruptType がDXGK_INTERRUPT_MICACAST_CHUNK_PROCESSING_COMPLETEされるときに使用される構造体。 WDDM 1.3 以降でサポートされているディスプレイ ミニポート ドライバーは、Windows 8.1 以降で実行されています。
MiracastEncodeChunkCompleted.VidPnTargetId
ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、エンコードが実行されているビデオの現在のターゲットを表します。 Windows 8.1 以降でサポートされています。
MiracastEncodeChunkCompleted.ChunkInfo
DXGK_MIRACAST_CHUNK_INFOディスプレイ ミニポート ドライバーが報告するチャンク情報構造をエンコードします。 Windows 8.1 以降でサポートされています。
MiracastEncodeChunkCompleted.pPrivateDriverData
このエンコード チャンクを記述するプライベート データのブロックへのポインター。 Windows 8.1 以降でサポートされています。
MiracastEncodeChunkCompleted.PrivateDataDriverSize
pPrivateDriverData 内のプライベート データのブロックのサイズ (バイト単位)。 この値は、ドライバーがDXGK_MIRACAST_CAPS構造体で報告した MaxChunkPrivateDriverDataSize 値より大きくすることはできません。 Windows 8.1 以降でサポートされています。
MiracastEncodeChunkCompleted.Status
エンコード チャンクがチャンクのキューに正常に追加されたかどうかを示す NTSTATUS 型の値。 成功した場合は、 STATUS_SUCCESS が返されます。 他の値が返された場合、チャンクをキューに追加できず、未処理のチャンクはすべて失われます。 Windows 8.1 以降でサポートされています。
値 | 意味 |
---|---|
STATUS_SUCCESS | チャンクがキューに正常に追加されました。 |
STATUS_INVALID_PARAMETER | パラメーターが検証され、正しくないと判断されました。 |
STATUS_NO_MEMORY | 割り込みサービス ルーチン (ISR) で、空きエンコード チャンクが不足しました。 |
DmaPageFaulted
InterruptType がDXGK_INTERRUPT_DMA_PAGE_FAULTEDされるときに使用される構造体。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedFenceId
エラーが発生したコマンドの送信フェンス ID。
障害が発生したフェンスを確実に特定できない場合は、 PageFaultFlagsにDXGK_PAGE_FAULT_FENCE_INVALID ビットが設定されている必要があり、 FaultedFenceId を 0 に設定する必要があります。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedPrimitiveAPISequenceNumber
描画フェンスごとの書き込みが有効になっている場合は、ページ フォールトの原因となった描画操作が識別されます。または、そのような情報が利用できない場合は DXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWN 。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedPipelineStage
エラーが生成されたパイプライン ステージをレンダリングするか、そのような情報が利用できない場合は DXGK_RENDER_PIPELINE_STAGE_UNKNOWN します。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedBindTableEntry
障害発生時にアクセスされるリソースのバインド テーブル インデックス。そのような情報が利用できない場合は DXGK_BIND_TABLE_ENTRY_UNKNOWN 。 Windows 10 以降でサポートされています。
DmaPageFaulted.PageFaultFlags
エラーの性質 を指定DXGK_PAGE_FAULT_FLAGS 列挙で説明されているフラグ。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedVirtualAddress
障害の GPU 仮想アドレス。または、障害に別の原因がある場合は D3DGPU_NULL 。 後者の場合は、GPU エラーを説明するために FaultErrorCode フィールドを使用する必要があります。 Windows 10 以降でサポートされています。
DmaPageFaulted.NodeOrdinal
通知を生成するエンジンのノード序数。 Windows 10 以降でサポートされています。
DmaPageFaulted.EngineOrdinal
通知を生成するエンジンのエンジン序数。 Windows 10 以降でサポートされています。
DmaPageFaulted.PageTableLevel
エラーが発生した操作が試行されたページ テーブル レベルについて説明します。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultErrorCode
エラーを記述する DXGK_FAULT_ERROR_CODE 構造体。 Windows 10 以降でサポートされています。
DmaPageFaulted.FaultedProcessHandle
ページ フォールトを生成したプロセスの DirectX グラフィックス カーネル プロセス ハンドル。エラーが発生したプロセスを特定できない場合は NULL 。 Windows 10 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2
InterruptType がDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY2されるときに使用される構造体。 Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.VidPnTargetId
マルチプレーン オーバーレイ Vidpn ターゲット ID を持つ Vsync。Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.PhysicalAdapterMask
垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.MultiPlaneOverlayVsyncInfoCount
表示できるオーバーレイ 平面の数。 Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.pMultiPlaneOverlayVsyncInfo
VSync によって更新された各オーバーレイ プレーンの情報を指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 構造体へのポインター。 Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.GpuFrequency
GPU クロック カウンターの周波数。 Windows 10 バージョン 1607 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay2.GpuClockCounter
VSYNC 割り込み時の GPU クロック カウンター。 GpuFrequency と組み合わせると、VSYNC 割り込みの時間が示されます。 Windows 10 バージョン 1607 以降でサポートされています。
MonitoredFenceSignaled
InterruptType がDXGK_INTERRUPT_MONITORED_FENCE_SIGNALEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。
MonitoredFenceSignaled.NodeOrdinal
通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。
MonitoredFenceSignaled.EngineOrdinal
通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。
HwContextListSwitchCompleted
InterruptType がDXGK_INTERRUPT_HWCONTEXTLIST_SWITCH_COMPLETEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。
HwContextListSwitchCompleted.NodeOrdinal
通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。
HwContextListSwitchCompleted.EngineOrdinal
通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。
HwContextListSwitchCompleted.ContextSwitchFence
この切り替え操作の実行に使用されるコンテキスト スイッチ フェンス。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted
InterruptType がDXGK_INTERRUPT_HWQUEUE_PAGE_FAULTEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedFenceId
障害が発生したコマンドの HW キュー進行状況フェンス ID。 障害が発生したフェンスを確実に判断できない場合は、PageFaultFlags に DXGK_PAGE_FAULT_FENCE_INVALID フラグを設定する必要があります。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedVirtualAddress
障害の仮想アドレス。障害に別の原因がある場合は 0。 後者の場合は、GPU エラーを記述するために FaultErrorCode フィールドを使用する必要があります。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedPrimitiveAPISequenceNumber
描画フェンスごとの書き込みが有効になっている場合は、ページ フォールトの原因となった描画を識別するか、そのような情報が使用できない場合はDXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWNします。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedHwQueue
DXGK_PAGE_FAULT_FENCE_INVALIDが設定されていない場合は、障害を生成した HW キューのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedHwContext
DXGK_PAGE_FAULT_FENCE_INVALIDとDXGK_PAGE_FAULT_HW_CONTEXT_VALIDが設定されている場合は、障害を生成した HW コンテキストのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedProcessHandle
Wen DXGK_PAGE_FAULT_FENCE_INVALID と DXGK_PAGE_FAULT_PROCESS_HANDLE_VALID が設定され、エラーを生成したプロセスのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.NodeOrdinal
通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.EngineOrdinal
通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedPipelineStage
エラーが生成されたパイプライン ステージをレンダリングするか、そのような情報が利用できない場合はDXGK_RENDER_PIPELINE_STAGE_UNKNOWNします。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultedBindTableEntry
障害発生時にアクセスされるリソースのバインド テーブル インデックス。または、そのような情報が利用できない場合はDXGK_BIND_TABLE_ENTRY_UNKNOWN。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.PageFaultFlags
ページ フォールトと回復ポリシーの性質を指定するフラグ。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.PageTableLevel
エラー処理が試行されたページ テーブル レベルについて説明します。 Windows 10 バージョン 1703 以降でサポートされています。
HwQueuePageFaulted.FaultErrorCode
エラーを記述するエラー コードを含む構造体。 Windows 10 バージョン 1703 以降でサポートされています。
PeriodicMonitoredFenceSignaled
InterruptType がDXGK_INTERRUPT_PERIODIC_MONITORED_FENCE_SIGNALEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。
PeriodicMonitoredFenceSignaled.VidPnTargetId
監視対象フェンスを通知する表示。 Windows 10 バージョン 1703 以降でサポートされています。
PeriodicMonitoredFenceSignaled.NotificationID
複数の通知 ID を 1 つの VidPnSource にアタッチできます。 Windows 10 バージョン 1703 以降でサポートされています。
SchedulingLogInterrupt
InterruptType がDXGK_INTERRUPT_SCHEDULING_LOG_INTERRUPTされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。
SchedulingLogInterrupt.NodeOrdinal
スケジュール ログ割り込みを発生させたエンジンのノード序数。 Windows 10 バージョン 1803 以降でサポートされています。
SchedulingLogInterrupt.EngineOrdinal
スケジュール ログ割り込みを発生させたエンジンのエンジン序数。 Windows 10 バージョン 1803 以降でサポートされています。
GpuEngineTimeout
InterruptType がDXGK_INTERRUPT_GPU_ENGINE_TIMEOUTされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。
GpuEngineTimeout.NodeOrdinal
タイムアウトし、リセットが必要なエンジンのノード序数。 Windows 10 バージョン 1803 以降でサポートされています。
GpuEngineTimeout.EngineOrdinal
タイムアウトし、リセットが必要なエンジンのエンジン序数。 Windows 10 バージョン 1803 以降でサポートされています。
SuspendContextCompleted
InterruptType がDXGK_INTERRUPT_SUSPEND_CONTEXT_COMPLETEDされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。
SuspendContextCompleted.hContext
中断確認の対象となるハードウェア コンテキスト。 Windows 10 バージョン 1803 以降でサポートされています。
SuspendContextCompleted.ContextSuspendFence
コンテキストはフェンスを中断します。 Windows 10 バージョン 1803 以降でサポートされています。
CrtcVsyncWithMultiPlaneOverlay3
InterruptType がDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY3されるときに使用される構造体。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.VidPnTargetId
マルチプレーン オーバーレイ Vidpn ターゲット ID を持つ Vsync。Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.PhysicalAdapterMask
垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.MultiPlaneOverlayVsyncInfoCount
CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo が指すDXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3構造体の数。 これらの構造体は、表示できるオーバーレイ 平面を表します。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo
VSync によって更新された各オーバーレイ プレーンの情報を指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 構造体の配列へのポインター。 詳細については、「 ハードウェア フリップ キュー 」を参照してください。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.GpuFrequency
GPU クロック カウンターの周波数。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
CrtcVsyncWithMultiPlaneOverlay3.GpuClockCounter
VSYNC 割り込み時の GPU クロック カウンター。 GpuFrequency と組み合わせると、VSYNC 割り込みの時間が示されます。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。
NativeFenceSignaled
[入力] InterruptType が DXGK_INTERRUPT_NATIVE_FENCE_SIGNALEDされるときに使用される構造体。 ネイティブ フェンスの詳細については、「 ネイティブ GPU フェンス オブジェクト」を参照してください。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
NativeFenceSignaled.NodeOrdinal
通知を生成するエンジンのノード序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
NativeFenceSignaled.EngineOrdinal
通知を生成するエンジンのエンジン序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
NativeFenceSignaled.SignaledNativeFenceCount
pSignaledNativeFenceArray が指すシグナルネイティブ フェンス配列のサイズ。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
NativeFenceSignaled.pSignaledNativeFenceArray
通知され、ウェイターのブロックを解除する必要があるすべてのネイティブ フェンスの OS カーネル モード ハンドルを含む配列。 この配列が空の場合、OS は、シグナルネイティブ フェンス配列で指定されたサブセットではなく、保留中のすべてのネイティブ フェンス ウェイターを再スキャンします。 Dxgkrnl は 、DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt が FALSE の場合にのみ、この値を読み取ります。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
NativeFenceSignaled.hHWQueue
割り込みを発生させたエンジンで実行されている HWQueue の KMD ハンドル。 このハンドルが NULL の場合、 Dxgkrnl はこのエンジン上のすべての HWQueues のログ バッファーを再スキャンします。 Dxgkrnl は 、DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt が TRUE の場合にのみ、この値を読み取ります。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。
EngineStateChange
[入力] InterruptType が DXGK_INTERRUPT_GPU_ENGINE_STATE_CHANGEされるときに使用される構造体。 詳細については、「 ユーザー モードの作業の送信」を参照してください。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。
EngineStateChange.NodeOrdinal
状態が変更されたエンジンのノード序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。
EngineStateChange.EngineOrdinal
状態が変更されたエンジンのエンジン序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。
EngineStateChange.NewState
エンジン の新 しい状態を指定するDXGK_ENGINE_STATE値。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。
Reserved
将来利用するために予約されています。
Reserved.Reserved[16]
将来使用するために予約されている 32 ビット値の配列。
Flags
ディスプレイ ミニポート ドライバーが DxgkCbNotifyInterrupt 関数の呼び出しで物理アダプター マスクを提供するかどうかを示すDXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS構造体。
注釈
ミニポート ドライバーは 、DXGKARGCB_NOTIFY_INTERRUPT_DATAを入力し、割り込みと同期する DXGKCB_SYNCHRONIZE_EXECUTION コールバックを使用します。 DXGKCB_SYNCHRONIZE_EXECUTION コールバックの SynchronizeRoutine パラメーターは、必要に応じて OS によって呼び出されるミニポート実装関数を指し、ドライバーはパラメーター情報を入力してから、DXGKCB_NOTIFY_INTERRUPT コールバックを使用して OS にコールバックします。 その後、OS は割り込みを処理し、スケジューラは DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 構造体の情報を使用します。
InterruptType メンバーの値に応じて、ディスプレイ ミニポート ドライバーは、この構造体の適切な共用体メンバーを設定する必要があります。 たとえば、InterruptType の DXGK_INTERRUPT_DMA_COMPLETED の値に対応するダイレクト メモリ アクセス (DMA) バッファー フェンスの末尾では、ドライバーは DmaCompleted メンバーの SubmissionFenceId メンバーに値を設定する必要があります。 この値は、ドライバーの DxgkDdiSubmitCommand 関数が完了したばかりの DMA バッファーに割り当てられる DMA バッファー フェンス識別子である必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista (WDDM 1.0) |
Header | d3dkmddi.h (D3dkmddi.h を含む) |
こちらもご覧ください
DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO
DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS