struttura DXGKARGCB_NOTIFY_INTERRUPT_DATA (d3dkmddi.h)
La struttura DXGKARGCB_NOTIFY_INTERRUPT_DATA contiene informazioni sulle notifiche di interrupt per la funzione di callback DXGKCB_NOTIFY_INTERRUPT.
Sintassi
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;
Membri
InterruptType
Valore DXGK_INTERRUPT_TYPE-typed che indica il tipo di interruzione del driver di miniport di visualizzazione notifica all'utilità di pianificazione GPU.
DmaCompleted
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_DMA_COMPLETED.
DmaCompleted.SubmissionFenceId
Identificatore di recinto del buffer DMA del comando completato. Questo identificatore è stato assegnato durante una chiamata alla funzione DXGKDDI_SUBMITCOMMAND del driver per il buffer DMA completato più recente.
DmaCompleted.NodeOrdinal
Indice in base zero del nodo che genera la notifica.
DmaCompleted.EngineOrdinal
Indice in base zero del motore, all'interno del nodo che NodeOrdinal specificato, che genera la notifica. Per le schede grafiche che non fanno parte di un collegamento, è consigliabile impostare sempre EngineOrdinal su 0. Per le schede grafiche che fanno parte di un collegamento, impostare EngineOrdinal sull'indice dell'adattatore dell'adattatore nel collegamento a cui appartiene il motore di interruzione.
DmaPreempted
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_DMA_PREEMPTED.
DmaPreempted.PreemptionFenceId
Identificatore di invio della richiesta di precedenza.
DmaPreempted.LastCompletedFenceId
Identificatore di invio dell'ultimo comando completato prima della precedenza.
DmaPreempted.NodeOrdinal
Indice in base zero del nodo che genera la notifica.
DmaPreempted.EngineOrdinal
Indice in base zero del motore, all'interno del nodo che NodeOrdinal specificato, che genera la notifica. Per le schede grafiche che non fanno parte di un collegamento, è consigliabile impostare sempre EngineOrdinal impostato su 0. Per le schede grafiche che fanno parte di un collegamento, impostare EngineOrdinal sull'indice dell'adattatore dell'adattatore nel collegamento a cui appartiene il motore di interruzione. L'utilità di pianificazione GPU determina che l'hardware ha preceduto tutti i comandi tra la richiesta di precedenza e l'invio che LastCompletedFenceId specificato.
DmaFaulted
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_DMA_FAULTED.
DmaFaulted.FaultedFenceId
Identificatore del comando difettoso.
DmaFaulted.Status
Stato del comando difettoso.
DmaFaulted.NodeOrdinal
Indice in base zero del nodo che genera la notifica.
DmaFaulted.EngineOrdinal
Indice in base zero del motore, all'interno del nodo che NodeOrdinal specificato, che genera la notifica. Per le schede grafiche che non fanno parte di un collegamento, è consigliabile impostare sempre EngineOrdinal su 0. Per le schede grafiche che fanno parte di un collegamento, impostare EngineOrdinal sull'indice dell'adattatore dell'adattatore nel collegamento a cui appartiene il motore di interruzione.
CrtcVsync
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_CRTC_VSYNC.
CrtcVsync.VidPnTargetId
Numero di identificazione in base zero del video presente nella destinazione in un percorso di una topologia di rete (VidPN) video presente. Questo numero rappresenta la destinazione del video presente in cui si verifica la sincronizzazione verticale.
CrtcVsync.PhysicalAddress
Indirizzo fisico del buffer di visualizzazione. Quando la visibilità del monitoraggio è disattivata, il sistema operativo prevede comunque un indirizzo fisico nonNULL. Questo indirizzo deve essere impostato sull'indirizzo fisico da cui la pipeline pixel leggerebbe se la visibilità fosse attivata.
CrtcVsync.PhysicalAdapterMask
Maschera adattatore fisico in cui si verifica la sincronizzazione verticale. Se questo membro contiene un valore valido, il driver deve anche impostare l'ValidPhysicalAdapterMask flag di campo di bit nel membro Flags.
DisplayOnlyVsync
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_DISPLAYONLY_VSYNC. Supportato a partire da Windows 8.
DisplayOnlyVsync.VidPnTargetId
Per un driver di sola visualizzazione, il numero di identificazione in base zero del video di destinazione presente in un percorso di una topologia di rete (VidPN) video presente. Questo numero rappresenta la destinazione del video presente in cui si verifica la sincronizzazione verticale. Supportato a partire da Windows 8.
CrtcVsyncWithMultiPlaneOverlay
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY. Fornisce notifiche VSync per visualizzare i driver miniport che supportano sovrimpressioni multipla. Supportato a partire da Windows 8.
CrtcVsyncWithMultiPlaneOverlay.VidPnTargetId
Numero di identificazione in base zero del video presente nella destinazione in un percorso di una topologia di rete (VidPN) video presente. Questo numero rappresenta la destinazione del video presente in cui si verifica la sincronizzazione verticale. Supportato a partire da Windows 8.
CrtcVsyncWithMultiPlaneOverlay.PhysicalAdapterMask
Maschera adattatore fisico in cui si verifica la sincronizzazione verticale. Se questo membro contiene un valore valido, il driver deve anche impostare l'ValidPhysicalAdapterMask flag di campo di bit nel membro Flags. Supportato a partire da Windows 8.
CrtcVsyncWithMultiPlaneOverlay.MultiPlaneOverlayVsyncInfoCount
Numero di piani di sovrimpressione disponibili per la visualizzazione. Supportato a partire da Windows 8.
CrtcVsyncWithMultiPlaneOverlay.pMultiPlaneOverlayVsyncInfo
Puntatore a una struttura DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO che specifica un piano di sovrapposizione da visualizzare durante un intervallo VSync. Supportato a partire da Windows 8.
DisplayOnlyPresentProgress
Struttura DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS che fornisce lo stato di avanzamento dell'operazione presente del driver (KMDOD) in modalità kernel. Utilizzato quando interruptType è DXGK_INTERRUPT_DISPLAYONLY_PRESENT_PROGRESS. Supportato a partire da Windows 8.
MiracastEncodeChunkCompleted
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_MICACAST_CHUNK_PROCESSING_COMPLETE. Supportato da WDDM 1.3 e versioni successive visualizza i driver miniport in esecuzione in Windows 8.1 e versioni successive.
MiracastEncodeChunkCompleted.VidPnTargetId
Numero di identificazione in base zero del video presente nella destinazione in un percorso di una topologia di rete (VidPN) video presente. Questo numero rappresenta la destinazione del video in cui viene eseguita la codifica. Supportato a partire da Windows 8.1.
MiracastEncodeChunkCompleted.ChunkInfo
Oggetto DXGK_MIRACAST_CHUNK_INFO codificare una struttura di informazioni di blocco che il driver miniport di visualizzazione vuole segnalare. Supportato a partire da Windows 8.1.
MiracastEncodeChunkCompleted.pPrivateDriverData
Puntatore a un blocco di dati privati che descrive questo blocco di codifica. Supportato a partire da Windows 8.1.
MiracastEncodeChunkCompleted.PrivateDataDriverSize
Dimensioni, in byte, del blocco di dati privati in pPrivateDriverData. Questo valore non deve essere maggiore del valore MaxChunkPrivateDriverDataSize restituito dal driver nella struttura DXGK_MIRACAST_CAPS. Supportato a partire da Windows 8.1.
MiracastEncodeChunkCompleted.Status
Valore di tipo NTSTATUS che indica se il blocco di codifica è stato aggiunto correttamente alla coda di blocchi. In caso di esito positivo, viene restituito STATUS_SUCCESS. Se viene restituito un altro valore, il blocco non può essere aggiunto alla coda e tutti i blocchi in sospeso andranno persi. Supportato a partire da Windows 8.1.
| Valore | Significato |
|---|---|
| STATUS_SUCCESS | Il blocco è stato aggiunto correttamente alla coda. |
| STATUS_INVALID_PARAMETER | I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti. |
| STATUS_NO_MEMORY | L'interrupt-service-routine (ISR) ha esaurito blocchi di codifica gratuiti. |
DmaPageFaulted
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_DMA_PAGE_FAULTED. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedFenceId
ID di isolamento di invio del comando con errori.
Se non è possibile determinare in modo affidabile il recinto difettoso, PageFaultFlags deve avere DXGK_PAGE_FAULT_FENCE_INVALID bit impostato e FaultedFenceId deve essere impostato su 0. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedPrimitiveAPISequenceNumber
Quando la scrittura del recinto di disegno è abilitata, identifica l'operazione di disegno che ha causato l'errore della pagina o DXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedPipelineStage
Fase di rendering della pipeline durante la quale è stato generato l'errore o DXGK_RENDER_PIPELINE_STAGE_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedBindTableEntry
Indice della tabella di associazione di una risorsa a cui si accede al momento dell'errore o DXGK_BIND_TABLE_ENTRY_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10.
DmaPageFaulted.PageFaultFlags
Flag descritti in DXGK_PAGE_FAULT_FLAGS'enumerazione che specifica la natura dell'errore. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedVirtualAddress
Indirizzo virtuale GPU di errore o D3DGPU_NULL se l'errore ha un'altra causa. Nel secondo caso, campo FaultErrorCode deve essere usato per descrivere l'errore GPU. Supportato a partire da Windows 10.
DmaPageFaulted.NodeOrdinal
Numero ordinale del nodo del motore che genera la notifica. Supportato a partire da Windows 10.
DmaPageFaulted.EngineOrdinal
Ordinale del motore del motore che genera la notifica. Supportato a partire da Windows 10.
DmaPageFaulted.PageTableLevel
Descrive il livello di tabella della pagina in cui è stata tentata l'operazione di errore. Supportato a partire da Windows 10.
DmaPageFaulted.FaultErrorCode
Struttura DXGK_FAULT_ERROR_CODE che descrive l'errore. Supportato a partire da Windows 10.
DmaPageFaulted.FaultedProcessHandle
Gestione del processo del kernel della grafica DirectX del processo che ha generato un errore di pagina o NULL se non è possibile determinare il processo con errori. Supportato a partire da Windows 10.
CrtcVsyncWithMultiPlaneOverlay2
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY2. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.VidPnTargetId
Vsync con id di destinazione Vidpn sovrapposto multiplane. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.PhysicalAdapterMask
Maschera adattatore fisico in cui si verifica la sincronizzazione verticale. Se questo membro contiene un valore valido, il driver deve anche impostare l'ValidPhysicalAdapterMask flag di campo di bit nel membro Flags. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.MultiPlaneOverlayVsyncInfoCount
Numero di piani di sovrimpressione disponibili per la visualizzazione. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.pMultiPlaneOverlayVsyncInfo
Puntatore a una struttura DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 che specifica le informazioni per ogni piano di sovrimpressione aggiornato da VSync. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.GpuFrequency
Frequenza del contatore dell'orologio GPU. Supportato a partire da Windows 10 versione 1607.
CrtcVsyncWithMultiPlaneOverlay2.GpuClockCounter
Contatore dell'orologio GPU al momento dell'interrupt VSYNC. In combinazione con GpuFrequency, indica l'ora dell'interrupt VSYNC. Supportato a partire da Windows 10 versione 1607.
MonitoredFenceSignaled
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_MONITORED_FENCE_SIGNALED. Supportato a partire da Windows 10 versione 1703.
MonitoredFenceSignaled.NodeOrdinal
Ordinale del nodo del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
MonitoredFenceSignaled.EngineOrdinal
Ordinale del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
HwContextListSwitchCompleted
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_HWCONTEXTLIST_SWITCH_COMPLETED. Supportato a partire da Windows 10 versione 1703.
HwContextListSwitchCompleted.NodeOrdinal
Ordinale del nodo del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
HwContextListSwitchCompleted.EngineOrdinal
Ordinale del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
HwContextListSwitchCompleted.ContextSwitchFence
Isolamento del commutatore di contesto usato per eseguire questa operazione switch. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_HWQUEUE_PAGE_FAULTED. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedFenceId
ID di isolamento dello stato della coda HW del comando con errori. Se non è stato possibile determinare il recinto difettoso PageFaultFlags in modo affidabile, deve essere impostato DXGK_PAGE_FAULT_FENCE_INVALID flag. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedVirtualAddress
Indirizzo virtuale di errore o 0 se l'errore ha un'altra causa. Nel secondo caso, il campo FaultErrorCode deve essere usato per descrivere l'errore GPU. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedPrimitiveAPISequenceNumber
Quando la scrittura del recinto di disegno è abilitata, identifica il disegno che ha causato l'errore della pagina o DXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedHwQueue
Quando DXGK_PAGE_FAULT_FENCE_INVALID non è impostato, specifica l'handle della coda HW che ha generato l'errore. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedHwContext
Quando vengono impostati DXGK_PAGE_FAULT_FENCE_INVALID e DXGK_PAGE_FAULT_HW_CONTEXT_VALID, specifica l'handle del contesto HW che ha generato l'errore. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedProcessHandle
Vengono impostati DXGK_PAGE_FAULT_FENCE_INVALID e DXGK_PAGE_FAULT_PROCESS_HANDLE_VALID, specifica l'handle del processo che ha generato l'errore. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.NodeOrdinal
Ordinale del nodo del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.EngineOrdinal
Ordinale del motore che genera la notifica. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedPipelineStage
Fase di rendering della pipeline durante la quale è stato generato l'errore o DXGK_RENDER_PIPELINE_STAGE_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultedBindTableEntry
Indice della tabella di associazione di una risorsa a cui si accede al momento dell'errore o DXGK_BIND_TABLE_ENTRY_UNKNOWN se tali informazioni non sono disponibili. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.PageFaultFlags
Flag che specificano la natura dei criteri di errore e ripristino della pagina. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.PageTableLevel
Livello di tabella della pagina descritto su cui è stata tentata l'operazione di errore. Supportato a partire da Windows 10 versione 1703.
HwQueuePageFaulted.FaultErrorCode
Struttura contenente il codice di errore che descrive l'errore. Supportato a partire da Windows 10 versione 1703.
PeriodicMonitoredFenceSignaled
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_PERIODIC_MONITORED_FENCE_SIGNALED. Supportato a partire da Windows 10 versione 1703.
PeriodicMonitoredFenceSignaled.VidPnTargetId
Display che segnala il recinto monitorato. Supportato a partire da Windows 10 versione 1703.
PeriodicMonitoredFenceSignaled.NotificationID
L'ID di notifica come più può essere collegato a un VidPnSource. Supportato a partire da Windows 10 versione 1703.
SchedulingLogInterrupt
Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_SCHEDULING_LOG_INTERRUPT. Supportato a partire da Windows 10 versione 1803.
SchedulingLogInterrupt.NodeOrdinal
Ordinale del nodo del motore che ha generato l'interrupt del log di pianificazione. Supportato a partire da Windows 10 versione 1803.
SchedulingLogInterrupt.EngineOrdinal
Ordinale del motore che ha generato l'interrupt del log di pianificazione. Supportato a partire da Windows 10 versione 1803.
GpuEngineTimeout
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_GPU_ENGINE_TIMEOUT. Supportato a partire da Windows 10 versione 1803.
GpuEngineTimeout.NodeOrdinal
Ordinale del nodo del motore che ha timeout e richiede la reimpostazione. Supportato a partire da Windows 10 versione 1803.
GpuEngineTimeout.EngineOrdinal
Ordinale del motore del motore che si è timeout e richiede la reimpostazione. Supportato a partire da Windows 10 versione 1803.
SuspendContextCompleted
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_SUSPEND_CONTEXT_COMPLETED. Supportato a partire da Windows 10 versione 1803.
SuspendContextCompleted.hContext
Contesto hardware per cui è previsto il riconoscimento di sospensione. Supportato a partire da Windows 10 versione 1803.
SuspendContextCompleted.ContextSuspendFence
Isolamento di sospensione del contesto. Supportato a partire da Windows 10 versione 1803.
CrtcVsyncWithMultiPlaneOverlay3
Struttura utilizzata quando interruptType è DXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY3. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.VidPnTargetId
Vsync con id di destinazione Vidpn sovrapposto multiplane. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.PhysicalAdapterMask
Maschera adattatore fisico in cui si verifica la sincronizzazione verticale. Se questo membro contiene un valore valido, il driver deve anche impostare l'ValidPhysicalAdapterMask flag di campo di bit nel membro Flags. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.MultiPlaneOverlayVsyncInfoCount
Numero di strutture DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 a cui CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo. Queste strutture descrivono i piani di sovrapposizione disponibili per la visualizzazione. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo
Puntatore a una matrice di strutture DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 che specificano le informazioni per ogni piano di sovrimpressione aggiornato da VSync. Per altre informazioni, vedere della coda di scorrimento hardware. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.GpuFrequency
Frequenza del contatore dell'orologio GPU. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
CrtcVsyncWithMultiPlaneOverlay3.GpuClockCounter
Contatore dell'orologio GPU al momento dell'interrupt VSYNC. In combinazione con GpuFrequency, indica l'ora dell'interrupt VSYNC. Disponibile a partire da Windows Server 2022 (WDDM 2.9).
NativeFenceSignaled
[in] Struttura utilizzata quando InterruptType è DXGK_INTERRUPT_NATIVE_FENCE_SIGNALED. Per altre informazioni sulle recinzioni native, vedere oggetti di isolamento GPU nativi. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
NativeFenceSignaled.NodeOrdinal
Numero ordinale del nodo del motore che genera la notifica. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
NativeFenceSignaled.EngineOrdinal
Ordinale del motore del motore che genera la notifica. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
NativeFenceSignaled.SignaledNativeFenceCount
Dimensioni della matrice di recinto nativo segnalato a cui pSignaledNativeFenceArray punti. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
NativeFenceSignaled.pSignaledNativeFenceArray
Matrice contenente handle in modalità kernel del sistema operativo di tutte le recinzioni native segnalate e che richiedono che i camerieri vengano sbloccati. Se questa matrice è vuota, il sistema operativo eseguirà nuovamente l'analisi di tutti i camerieri di isolamento nativi in sospeso anziché il subset specificato dalla matrice di isolamento nativo segnalato. Dxgkrnl legge questo valore solo se DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt è FALSE. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
NativeFenceSignaled.hHWQueue
Handle KMD dell'HWQueue in esecuzione sul motore che ha generato l'interrupt. Se questo handle è NULL, Dxgkrnl analizzerà nuovamente il buffer di log di tutti gli HWQueue in questo motore. dxgkrnl legge questo valore solo se DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt è TRUE. Supportato a partire da Windows 11 versione 24H2 (WDDM 3.2).
EngineStateChange
[in] Struttura utilizzata quando interruptType è DXGK_INTERRUPT_GPU_ENGINE_STATE_CHANGE. Per altre informazioni, vedere invio di lavoro in modalità utente. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2).
EngineStateChange.NodeOrdinal
Ordinale del nodo del motore il cui stato è cambiato. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2).
EngineStateChange.EngineOrdinal
Ordinale del motore il cui stato è cambiato. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2).
EngineStateChange.NewState
Valore DXGK_ENGINE_STATE che specifica il nuovo stato del motore. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2).
Reserved
Riservato per uso futuro.
Reserved.Reserved[16]
Matrice di valori a 32 bit riservati per un uso futuro.
Flags
Struttura DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS che indica se il driver del miniport di visualizzazione fornisce una maschera adattatore fisica in una chiamata alla funzione DxgkCbNotifyInterrupt.
Osservazioni
Un driver miniport compila DXGKARGCB_NOTIFY_INTERRUPT_DATAe quindi usa il callback DXGKCB_SYNCHRONIZE_EXECUTION per la sincronizzazione con l'interrupt. Il parametro SynchronizeRoutine del callback DXGKCB_SYNCHRONIZE_EXECUTION punta a una funzione implementata da miniport che viene chiamata dal sistema operativo quando appropriato e quindi il driver compila le informazioni sui parametri prima di richiamare nel sistema operativo con il callback DXGKCB_NOTIFY_INTERRUPT. Il sistema operativo gestisce quindi l'interrupt, con l'utilità di pianificazione usando le informazioni nello struct DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2.
A seconda del valore nel membro InterruptType, il driver miniport di visualizzazione deve impostare il membro di unione appropriato in questa struttura. Ad esempio, per la fine di un limite di buffer DMA (Direct Memory Access), che corrisponde a un valore di DXGK_INTERRUPT_DMA_COMPLETED in InterruptType, il driver deve impostare un valore nel membro SubmissionFenceId del membro DmaCompleted. Questo valore deve essere l'identificatore di recinto del buffer DMA, che il driver DxgkDdiSubmitCommand funzione assegnata al buffer DMA appena completato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista (WDDM 1.0) |
| intestazione |
d3dkmddi.h (include D3dkmddi.h) |
Vedere anche
DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO
DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS