ID3D11VideoContext3::D ecoderBeginFrame1-Methode (d3d11_4.h)

  • Artikel

Startet einen Decodierungsvorgang zum Decodieren eines Videoframes.

Syntax

HRESULT DecoderBeginFrame1(
  ID3D11VideoDecoder           *pDecoder,
  ID3D11VideoDecoderOutputView *pView,
  UINT                         ContentKeySize,
  const void                   *pContentKey,
  UINT                         NumComponentHistograms,
  const UINT                   *pHistogramOffsets,
  ID3D11Buffer                 * const *ppHistogramBuffers
);

Parameter

pDecoder

Ein Zeiger auf die ID3D11VideoDecoder-Schnittstelle . Rufen Sie ID3D11VideoDevice::CreateVideoDecoder auf, um diesen Zeiger zu erhalten.

pView

Ein Zeiger auf eine ID3D11VideoDecoderOutputView-Schnittstelle . Diese Schnittstelle beschreibt die Ressource, die den decodierten Frame empfängt. Rufen Sie ID3D11VideoDevice::CreateVideoDecoderOutputView auf, um diesen Zeiger zu erhalten.

ContentKeySize

Die Größe des in pContentKey angegebenen Inhaltsschlüssels. Wenn pContentKey NULL ist, legen Sie ContentKeySize auf Null fest.

pContentKey

Ein optionaler Zeiger auf einen Inhaltsschlüssel, der zum Verschlüsseln der Framedaten verwendet wurde. Wenn kein Inhaltsschlüssel verwendet wurde, legen Sie diesen Parameter auf NULL fest. Wenn der Aufrufer einen Inhaltsschlüssel bereitstellt, muss der Aufrufer den Sitzungsschlüssel verwenden, um den Inhaltsschlüssel zu verschlüsseln.

NumComponentHistograms

Die Anzahl der Komponenten, für die ein Histogramm aufgezeichnet werden soll. Verwenden Sie D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM , um nach Support zu suchen. Verwenden Sie null, wenn Histogramme nicht aufgezeichnet werden oder wenn das Feature nicht unterstützt wird. Die Angabe von weniger Komponenten als im Format impliziert, dass für diese Komponenten keine Histogrammaufzeichnung aktiviert ist. Die maximale Anzahl von Komponenten wird als D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS definiert.

pHistogramOffsets

Ein Array von Startpufferoffsetpositionen innerhalb des parallelen Arrays ppHistogramBuffers . Verwenden Sie D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT , um das Array zu indizieren. Wenn keine Komponente angefordert wird, geben Sie einen Offset von 0 (null) an. Die Offsets müssen 256 Byte ausgerichtet sein.

ppHistogramBuffers

Ein Array von Zielpuffern für Hardware zum Schreiben des Komponentenhistogramms. Verwenden Sie D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT , um das Array zu indizieren. Legen Sie diesen Parameter auf NULLptr fest, wenn das Komponentenhistogramm deaktiviert oder nicht unterstützt wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Hinweise

Die folgenden D3D11_RESOURCE_MISC-Flags sind zulässig, wenn Ressourcen für Videodecodierungshistogramme zugewiesen werden.

  • D3D11_RESOURCE_MISC_SHARED
  • D3D11_RESOURCE_MISC_DRAWINDIRECT_ARGS
  • D3D11_RESOURCE_MISC_BUFFER_ALLOW_RAW_VIEWS
  • D3D11_RESOURCE_MISC_BUFFER_STRUCTURED
  • D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX
  • D3D11_RESOURCE_MISC_SHARED_NTHANDLE
  • D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE
  • D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER

Alle anderen D3D11_RESOURCE_MISC-Flags sind nicht zulässig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Kopfzeile d3d11_4.h