PFND3D11_1DDI_CREATEVIDEODECODER Rückruffunktion (d3d10umddi.h)

  • Artikel

Erstellt ein Videodecoderobjekt.

Syntax

PFND3D11_1DDI_CREATEVIDEODECODER Pfnd3d111DdiCreatevideodecoder;

HRESULT Pfnd3d111DdiCreatevideodecoder(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11_1DDIARG_CREATEVIDEODECODER *unnamedParam2,
  D3D11_1DDI_HDECODE unnamedParam3,
  D3D11_1DDI_HRTDECODE unnamedParam4
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

pCreateData [in]

Ein Zeiger auf eine D3D11_1DDIARG_CREATEVIDEODECODER Struktur. Diese Struktur gibt die Attribute des zu erstellenden Videodecoderobjekts an.

unnamedParam3

hDecode [in]

Ein Handle für die privaten Daten des Treibers für das Videodecoderobjekt.

unnamedParam4

hRTDecode [in]

Ein Handle für das Videodecoderobjekt, das der Treiber verwenden sollte, wenn er in die Runtime zurückruft.

Rückgabewert

CreateVideoDecoder gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Das Videodecoderobjekt wurde erfolgreich erstellt.
D3DDDIERR_DEVICEREMOVED Der Grafikkarte wurde entfernt.
E_OUTOFMEMORY Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen.

Hinweise

Die Microsoft Direct3D-Runtime ruft CreateVideoDecoder auf, nachdem sie die CalcPrivateVideoDecoderSize des Treibers aufgerufen hat, um die Größe in Bytes für die privaten Daten zu bestimmen, die der Treiber für das Videodecoderobjekt benötigt. Die Runtime weist den Arbeitsspeicher für diese privaten Daten für den Treiber zu. Der Treiber verwendet diesen Speicher, um private Daten zu speichern, die sich auf das Videodecoderobjekt beziehen.

Wenn die Runtime CreateVideoDecoder aufruft, übergibt sie das Handle an den privaten Datenspeicher im hDecoder-Parameter . Bei diesem Handle handelt es sich tatsächlich um einen Zeiger auf den Arbeitsspeicher.

Der Treiber muss den Handle für das Anzeigegerät nachverfolgen, das zum Erstellen der kryptografischen Sitzung verwendet wurde. Der Treiber sollte alle nachfolgenden Aufrufe, die diese erstellte kryptografische Sitzung verwenden, fehlschlagen, z. B . VideoDecoderBeginFrame, wenn sich das in diesen Aufrufen angegebene Anzeigegerät von dem Anzeigegerät unterscheidet, das zum Erstellen des Videodecoders verwendet wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

CalcPrivateVideoDecoderSize

D3D11_1DDIARG_CREATEVIDEODECODER

NegotiateCryptoSessionKeyExchange

VideoDecoderBeginFrame