IddCxSetRealtimeGPUPriority-Funktion (iddcx.h)
Ein indirekter Anzeigetreiber (IDD) ruft IddCxSetRealtimeGPUPriority auf, um die GPU-Priorität eines DirectX-Geräts auf 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 entsprechender NTSTATUS-Fehlercode wie der folgende zurückgegeben.
| Fehlercode | Bedeutung |
|---|---|
| E_INVALIDARG | Ein ungültiges Swapchainobjekt wurde bereitgestellt. |
| E_NOTIMPL | Die GPU-Prioritätserhöhung wird nicht unterstützt. Siehe Hinweise. |
Hinweise
Eine IDD kann diese Funktion aufrufen, um sicherzustellen, dass die GPU-Arbeit für die Verarbeitung eines Frames rechtzeitig abgeschlossen wird.
Bei Erfolg wird die GPU-Priorität für das bereitgestellte DXGI-Gerät auf Echtzeit erhöht. Dies bedeutet, dass jede von diesem Gerät geplante GPU-Arbeit eine höhere Priorität hat als jede reguläre Anwendung festlegen kann. Das Betriebssystem wählt die genaue Echtzeitprioritätsstufe aus, die festgelegt werden soll. Die ausgewä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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 22H2 |
| Kopfzeile | iddcx.h |