Partager via


ID3D11VideoContext3 ::D ecoderBeginFrame1, méthode (d3d11_4.h)

Démarre une opération de décodage pour décoder une image vidéo.

Syntaxe

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

Paramètres

pDecoder

Pointeur vers l’interface ID3D11VideoDecoder . Pour obtenir ce pointeur, appelez ID3D11VideoDevice ::CreateVideoDecoder

pView

Pointeur vers une interface ID3D11VideoDecoderOutputView . Cette interface décrit la ressource qui recevra le cadre décodé. Pour obtenir ce pointeur, appelez ID3D11VideoDevice ::CreateVideoDecoderOutputView.

ContentKeySize

Taille de la clé de contenu spécifiée dans pContentKey. Si pContentKey a la valeur NULL, définissez ContentKeySize sur zéro.

pContentKey

Pointeur facultatif vers une clé de contenu utilisée pour chiffrer les données de trame. Si aucune clé de contenu n’a été utilisée, définissez ce paramètre sur NULL. Si l’appelant fournit une clé de contenu, l’appelant doit utiliser la clé de session pour chiffrer la clé de contenu.

NumComponentHistograms

Nombre de composants pour ant enregistrer un histogramme. Utilisez D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM pour case activée de support. Utilisez zéro lorsque vous n’enregistrez pas d’histogrammes ou lorsque la fonctionnalité n’est pas prise en charge. La spécification d’un nombre de composants inférieur à celui au format implique que l’enregistrement d’histogramme de ces composants n’est pas activé. Le nombre maximal de composants est défini comme D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS.

pHistogramOffsets

Tableau d’emplacements de décalage de la mémoire tampon de démarrage dans le tableau parallèle ppHistogramBuffers . Utilisez D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT pour indexer le tableau. Si aucun composant n’est demandé, spécifiez un décalage de zéro. Les décalages doivent être alignés sur 256 octets.

ppHistogramBuffers

Tableau de mémoires tampons cibles pour le matériel permettant d’écrire l’histogramme des composants. Utilisez D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT pour indexer le tableau. Définissez ce paramètre sur nullptr lorsque l’histogramme du composant est désactivé ou non pris en charge

Valeur retournée

Retourne S_OK en cas de réussite.

Remarques

Les indicateurs de D3D11_RESOURCE_MISC suivants sont autorisés lors de l’allocation de ressources pour les histogrammes de décodage vidéo.

  • 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

Tous les autres indicateurs D3D11_RESOURCE_MISC sont interdits.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 Build 20348
Serveur minimal pris en charge Windows 10 Build 20348
En-tête d3d11_4.h