IddCxSetRealtimeGPUPriority-Funktion (iddcx.h)
Ein indirekter Anzeigetreiber (IDD) ruft IddCxSetRealtimeGPUPriority- auf, um die GPU-Priorität eines DirectX-Geräts in Echtzeit zu erhöhen.
Syntax
HRESULT IddCxSetRealtimeGPUPriority(
[in] IDDCX_SWAPCHAIN SwapChainObject,
[in] const IDARG_IN_SETREALTIMEGPUPRIORITY *pIn
);
Parameter
[in] SwapChainObject
Ein IDDCX_SWAPCHAIN-Objekt, das die Swapchain darstellt, die das bereitgestellte DXGI-Gerät verarbeitet.
[in] pIn
Zeiger auf eine IDARG_IN_SETREALTIMEGPUPRIORITY Struktur mit zusätzlichen Eingabeargumenten zum DXGI-Gerät.
Rückgabewert
IddCxSetRealtimeGPUPriority gibt STATUS_SUCCESS (S_OK) zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein geeigneter NTSTATUS-Fehlercode zurückgegeben, z. B. folgendes.
| Fehlercode | Bedeutung |
|---|---|
| E_INVALIDARG | Es wurde ein ungültiges Swapchainobjekt bereitgestellt. |
| E_NOTIMPL | Die GPU-Prioritätsverstärkung wird nicht unterstützt. Siehe Anmerkungen. |
Bemerkungen
Eine IDD kann diese Funktion aufrufen, um sicherzustellen, dass die GPU-Arbeit für die Verarbeitung eines Frames zeitnah abgeschlossen ist.
Bei Erfolg wird die GPU-Priorität für das bereitgestellte DXGI-Gerät in Echtzeit ausgelöst. Dies bedeutet, dass jede von diesem Gerät geplante GPU-Arbeit eine höhere Priorität hat, als jede normale Anwendung festlegen kann. Das Betriebssystem wählt die genaue Stufe der Echtzeitpriorität aus, die festgelegt werden soll. Die gewählte Ebene im Echtzeitprioritätsband kann sich in zukünftigen Betriebssystemversionen ändern.
Das Festlegen der Echtzeitpriorität wird in WDDM 1 nicht unterstützt.x Geräte; IddCxSetRealtimeGPUPriority gibt E_NOTIMPL für solche Geräte zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 22H2 |
| Header- | iddcx.h |