IDirectXVideoDecoder::GetCreationParameters-Methode (dxva2api.h)

Artikel
02/29/2024

Ruft die Parameter ab, die zum Erstellen dieses Geräts verwendet wurden.

Syntax

HRESULT GetCreationParameters(
  [out] GUID                      *pDeviceGuid,
  [out] DXVA2_VideoDesc           *pVideoDesc,
  [out] DXVA2_ConfigPictureDecode *pConfig,
  [out] IDirect3DSurface9         ***pDecoderRenderTargets,
  [out] UINT                      *pNumSurfaces
);

Parameter

[out] pDeviceGuid

Empfängt die Geräte-GUID. Dieser Parameter kann NULL sein.

[out] pVideoDesc

Zeiger auf eine DXVA2_VideoDesc-Struktur , die eine Beschreibung des Videoformats empfängt. Dieser Parameter kann NULL sein.

[out] pConfig

Zeiger auf eine DXVA2_ConfigPictureDecode-Struktur , die die Decoderkonfiguration empfängt. Dieser Parameter kann NULL sein.

[out] pDecoderRenderTargets

Empfängt ein Array von IDirect3DSurface9-Schnittstellenzeigern . Diese Zeiger stellen die Renderziele des Decoders dar. Die -Methode weist den Arbeitsspeicher für das Array zu und ruft AddRef für jeden zeiger auf. Der Aufrufer muss die Zeiger freigeben und CoTaskMemFree aufrufen, um den Arbeitsspeicher für das Array freizugeben. Dieser Parameter kann NULL sein.

[out] pNumSurfaces

Empfängt die Anzahl der Elemente im pppDecoderRenderTargets-Array . Dieser Parameter kann NULL sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Ungültiges Argument. Mindestens ein Parameter muss nicht NULL sein.

Hinweise

Sie können jeden Parameter auf NULL festlegen, wenn Sie nicht an dem Ergebnis interessiert sind. Mindestens ein Parameter muss nicht NULL sein.

Wenn Sie einen Nicht-NULL-Wert für pppDecoderRenderTargets angeben (zum Empfangen der Renderzielflächen), kann pNumSurfaces nicht NULL sein, da es die Größe des Arrays empfängt, das in pppDecoderRenderTargets zurückgegeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dxva2api.h

Weitere Informationen

DirectX VideoBeschleunigung 2.0

IDirectXVideoDecoder

Freigeben über