ID3D12SDKConfiguration::SetSDKVersion-Methode (d3d12.h)

Konfiguriert die zu verwendende SDK-Version.

Syntax

HRESULT SetSDKVersion(
  UINT   SDKVersion,
  LPCSTR SDKPath
);

Parameter

SDKVersion

Typ: UINT

Die festzulegende SDK-Version.

SDKPath

Typ: _In_z_ LPCSTR

Eine NULL-beendete Zeichenfolge, die den relativen Pfad zu d3d12core.dll der angegebenen SDKVersion bereitstellt. Der Pfad ist relativ zur Prozess-EXE des Aufrufers. Wenn d3d12core.dll nicht gefunden wird oder nicht der angegebenen SDKVersion entspricht, schlägt die Direct3D 12-Geräteerstellung fehl.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird einer der Direct3D 12-Rückgabecodes zurückgegeben.

Hinweise

Diese Methode kann nur im Windows-Entwicklermodus verwendet werden.

Um die SDK-Version mithilfe dieser API festzulegen, müssen Sie sie aufrufen, bevor Sie das Direct3D 12-Gerät erstellen. Wenn Sie diese API nach dem Erstellen des Direct3D 12-Geräts aufrufen, wird das Gerät von der Direct3D 12-Runtime entfernt.

Wenn die d3d12core.dll mit dem Betriebssystem installierte version neuer als die angegebene SDK-Version ist, wird stattdessen die Betriebssystemversion verwendet.

Sie können die Version einer bestimmten D3D12Core.dll aus dem exportierten Symbol D3D12SDKVersion abrufen, bei dem es sich um eine Variable vom Typ UINT handelt, genau wie die aus Anwendungen exportierten Variablen, um die Verwendung des Agility SDK zu ermöglichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3D12.lib
DLL D3D12.dll