IDXCoreAdapter::SetState-Methode
Legt den Status des angegebenen Elements auf dem Adapter fest. Rufen Sie vor dem Aufrufen von SetState für einen Eigenschaftstyp IsSetStateSupported auf, um zu bestätigen, dass die Einstellung der Zustandsart für diesen Adapter und das Betriebssystem verfügbar ist.
Syntax
virtual HRESULT STDMETHODCALLTYPE SetState(
DXCoreAdapterState state,
size_t inputStateDetailsSize,
_In_reads_bytes_opt_(inputStateDetailsSize) const void *inputStateDetails,
size_t inputDataSize,
_In_reads_bytes_(inputDataSize) const void *inputData) = 0;
template <class T1, class T2>
HRESULT SetState(
DXCoreAdapterState state,
const T1 *inputStateDetails,
const T2 *inputData);
Parameter
state
Typ: DXCoreAdapterState
Die Art des Zustandselements auf dem Adapter, dessen Zustand Sie festlegen möchten. Weitere Informationen zu den einzelnen Adapterzustandsart finden Sie in der Tabelle in DXCoreAdapterState .
inputStateDetailsSize
Typ: size_t
Die Größe des Eingabestatusdetailspuffers in Bytes, den Sie (optional) zuordnen und in inputStateDetails angeben.
inputStateDetails [in]
Typ: void const*
Ein optionaler Zeiger auf einen Puffer mit konstanten Eingabezustandsdetails, den Sie in Ihrer Anwendung zuweisen, der alle Informationen zu Ihrer Anforderung enthält, die für die Zustandsart erforderlich sind, die Sie im Zustand angeben. Weitere Informationen zu Eingabepufferanforderungen für eine bestimmte Zustandsart finden Sie in der Tabelle in DXCoreAdapterState .
inputDataSize
Typ: size_t
Die Größe des Eingabepuffers in Bytes, den Sie in inputData zuordnen und bereitstellen.
inputData [in]
Typ: void*
Ein Zeiger auf einen Eingabepuffer, den Sie in Ihrer Anwendung zuweisen, der die Zustandsinformationen enthält, die für das Zustandselement festgelegt werden sollen, dessen Art Sie im Zustand angeben. Weitere Informationen zur Eingabepufferanforderung für eine bestimmte Zustandsart finden Sie in der Tabelle in DXCoreAdapterState .
Gibt zurück
Typ: HRESULT
Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Rückgabewert | Beschreibung |
---|---|
DXGI_ERROR_DEVICE_REMOVED | Der Adapter befindet sich nicht mehr in einem gültigen Zustand. |
DXGI_ERROR_INVALID_CALL | Die im Zustand angegebene Zustandsart wird von diesem Betriebssystem nicht erkannt. Rufen Sie IsSetStateSupported auf , um zu bestätigen, dass die Einstellung der Zustandsart für diesen Adapter und das Betriebssystem verfügbar ist. |
DXGI_ERROR_UNSUPPORTED | Die im Status angegebene Zustandsart wird vom Adapter nicht unterstützt. Rufen Sie IsSetStateSupported auf , um zu bestätigen, dass die Einstellung der Zustandsart für diesen Adapter und das Betriebssystem verfügbar ist. |
E_INVALIDARG | Für inputData (oder für inputStateDetails , bei denen ein Eingabezustandsdetailspuffer erforderlich ist) wird eine unzureichende Puffergröße bereitgestellt. |
E_POINTER | nullptr wurde für inputData (oder für inputStateDetails , bei denen ein Puffer für Eingabezustandsdetails erforderlich ist) bereitgestellt. |
Siehe auch
IDXCoreAdapter, DXCore-Referenz, Verwenden von DXCore zum Auflisten von Adaptern
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für