PFND3DDDI_DECODEEXTENSIONEXECUTE Rückruffunktion (d3dumddi.h)
Die DecodeExtensionExecute--Funktion führt einen Decodierungsvorgang mithilfe des angegebenen DirectX Video Accelerator (DXVA) nicht standardmäßigen Decodierungserweiterungsgeräts durch.
Syntax
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData- [in, out]
Ein Zeiger auf eine D3DDDIARG_DECODEEXTENSIONEXECUTE Struktur, die den auszuführenden DXVA-Decodierungsvorgang beschreibt.
Rückgabewert
DecodeExtensionExecute gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der DirectX VA-Decodierungsvorgang wurde erfolgreich ausgeführt. |
| E_OUTOFMEMORY | DecodeExtensionExecute konnte den erforderlichen Speicher nicht zuordnen, damit er abgeschlossen werden kann. |
Bemerkungen
Ein Benutzermodusanzeigetreiber (UMD) kann die DecodeExtensionExecute-Funktion implementieren, um Erweiterungen der Standarddecodierungstypen (d. h. nicht standardmäßige Decodierungs-GUIDs) zu unterstützen. Diese nicht standardmäßigen Decodierungstypen sind nützlich für die Konfiguration von Verschlüsselung und anderen sonstigen Verbesserungen.
DecodeExtensionExecute wird aufgerufen, wenn DirectX VA 2.0-Decoder die nicht standardmäßigen Erweiterungen erfordern.
Aus Gründen der Kompatibilität mit DirectX VA 1.0-Decodern, die diese nicht standardmäßigen Erweiterungen erfordern, wird DecodeExtensionExecute aufgerufen, wenn ein DirectX VA 1.0-Decoder einen Ausführungsaufruf durchführt, in dem jeder bDXVA_Func Wert, der größer als 4 ist, in den wichtigsten 8 Bits des Function Member der D3DDDIARG_DECODEEXTENSIONEXECUTE-Struktur festgelegt wird. DecodeExtensionExecute wird auch aufgerufen, wenn DirectX VA 1.0-Decoder einen Konfigurationsaufruf vorgibt, in dem alle DXVA_ConfigQueryOrReplyFunc Flags außer DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) oder DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY (0xFFFFF5) in den wichtigsten 24 Bits von Functionfestgelegt werden. Weitere Informationen zu den Bedeutungen für die Biteinstellungen von Functionfinden Sie in den Themen DXVA_ConfigQueryOrReplyFlag und DXVA_ConfigQueryorReplyFunc Variablen und bDXVA_Func Variablen Themen.
Aufgrund von Kompatibilitätsproblemen mit DirectX VA 1.0-Decodern, die einen solchen Konfigurationsaufruf vor DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY ausführen können, können diese Decoder auch vor der Erstellung eines Decodierungsgeräts einen solchen Konfigurationsaufruf durchführen. Wenn ein solcher Konfigurationsaufruf ausgeführt wird, bevor ein Decodierengerät erstellt wird, wird das hDecode-Element der D3DDDIARG_DECODEEXTENSIONEXECUTE Struktur, auf die der pData-Parameter verweist, auf NULL festgelegt. In diesem Fall kann der Treiber erforderlich sein, um einen Fehler zurückzugeben (z. B. E_FAIL), wenn der Treiber die Situation nicht unterstützen kann, unabhängig von einem Decodierungsgerät.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |