PFND3DDDI_DECODEEXECUTE Rückruffunktion (d3dumddi.h)
Die DecodeExecute-Funktion führt einen Decodierungsvorgang mithilfe des angegebenen Microsoft DirectX Video Accelerator (VA)-Decodierungsgeräts aus.
Syntax
PFND3DDDI_DECODEEXECUTE Pfnd3dddiDecodeexecute;
HRESULT Pfnd3dddiDecodeexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXECUTE *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in]
Ein Zeiger auf eine D3DDDIARG_DECODEEXECUTE-Struktur , die den auszuführenden DirectX VA-Decodierungsvorgang beschreibt.
Rückgabewert
DecodeExecute gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der DirectX VA-Decodierungsvorgang wurde erfolgreich ausgeführt. |
| E_OUTOFMEMORY | DecodeExecute konnte nicht den erforderlichen Arbeitsspeicher zuweisen, damit er vollständig ist. |
Hinweise
Die Microsoft Direct3D-Runtime ruft die DecodeExecute-Funktion für alle Standardmäßigen DirectX VA-Decodierungsvorgänge auf. Wenn DecodeExecute zuerst für jeden Frame aufgerufen wird, sollte die D3DDDIARG_DECODEEXECUTE Struktur, die von pData angegeben wird, alle Pufferinformationen enthalten, die zum Decodieren des Frames erforderlich sind. DecodeExecute kann anschließend für denselben Frame aufgerufen werden; Diese Aufrufe erfordern jedoch nur inkrementelle Daten. Wenn die GUID für den bestimmten DirectX VA-Decodierungstyp keinen Puffer verwendet, der in D3DDDIARG_DECODEEXECUTE angegeben ist, werden das Handle und die Beschreibung für den Puffer auf NULL festgelegt. Da der MPEG2-Decodierungstyp beispielsweise Bildparameter, einen Makroblockpuffer und einen Restdifferenzpuffer erfordert, müssen alle diese Elemente im ersten Aufruf für jeden Frame vorhanden sein. Abhängig von der Größe der Daten ruft die Direct3D-Runtime decodeExecute jedoch möglicherweise erneut auf, um nur zusätzliche Restdifferenzdaten zur Verfügung zu stellen, die zum Decodieren des gesamten Frames erforderlich sind.
DirectX VA 1.0 unterstützte einen externen Synchronisierungsmechanismus über einen Aufruf der DdMoCompQueryStatus-Funktion . In DirectX VA 2.0 sollte der Benutzermodusanzeigetreiber eine eigene Synchronisierung durchführen, ähnlich der Synchronisierung der 3D-Pipe. Weitere Informationen zu dieser Synchronisierung finden Sie unter Synchronisieren von Videodecodierungsvorgängen.
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) |