PFND3DDDI_DECODEEXTENSIONEXECUTE Rückruffunktion (d3dumddi.h)

  • Artikel

Die DecodeExtensionExecute-Funktion führt einen Decodierungsvorgang mithilfe des angegebenen nicht standardmäßigen Decodierungsgeräts von Microsoft DirectX Video Accelerator (VA) aus.

Syntax

PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;

HRESULT Pfnd3dddiDecodeextensionexecute(
  HANDLE hDevice,
  const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDIARG_DECODEEXTENSIONEXECUTE-Struktur , die den auszuführenden DirectX VA-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 Arbeitsspeicher nicht zuordnen, damit er vollständig ist.

Hinweise

Ein Benutzermodusanzeigetreiber kann die DecodeExtensionExecute-Funktion implementieren, um Erweiterungen der Standarddecodierungstypen (d. a. nicht standardmäßige Decodierungs-GUIDs) zu unterstützen. Diese nicht standardmäßigen Decodierungstypen sind nützlich, um die Verschlüsselung und andere verbesserungen zu konfigurieren.

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 ausrichtet, in dem ein beliebiger bDXVA_Func Wert, der größer als 4 ist, in den wichtigsten 8 Bits des Funktionselements der D3DDDIARG_DECODEEXTENSIONEXECUTE-Struktur festgelegt ist. DecodeExtensionExecute wird auch aufgerufen, wenn der DirectX VA 1.0-Decoder einen Konfigurationsaufruf ausgibt, bei dem ein anderes DXVA_ConfigQueryOrReplyFunc-Flag als DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY (0xFFFFF1) oder DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY(0xFFFFF5)-Flag in den wichtigsten 24 Bits der Funktion festgelegt ist. Weitere Informationen zu den Bedeutungen für die Biteinstellungen von Function finden Sie in den Themen DXVA_ConfigQueryOrReplyFlag und DXVA_ConfigQueryorReplyFunc Variablen und bDXVA_Func Variablen .

Aufgrund von Kompatibilitätsproblemen mit DirectX VA 1.0-Decodern, die einen solchen Konfigurationsaufruf vor DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY durchführen, können diese Decoder einen solchen Konfigurationsaufruf auch vor der Erstellung eines Decodierungsgeräts durchführen. Wenn ein solcher Konfigurationsaufruf vor der Erstellung eines Decodierungsgeräts erfolgt, wird das hDecode-Element der D3DDDIARG_DECODEEXTENSIONEXECUTE Struktur, auf die der pData-Parameter verweist, auf NULL festgelegt. In dieser Situation muss der Treiber möglicherweise einen Fehler zurückgeben (z. B. E_FAIL), wenn der Treiber die Situation unabhängig von einem Decodierungsgerät nicht unterstützen kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_DECODEEXTENSIONEXECUTE

D3DDDI_DEVICEFUNCS