PFND3D11_1DDI_VIDEOPROCESSORBLT fonction de rappel (d3d10umddi.h)

Article
08/07/2023

Effectue une opération de traitement vidéo sur un ou plusieurs exemples d’entrée et écrit le résultat sur une surface Direct3D.

Syntaxe

PFND3D11_1DDI_VIDEOPROCESSORBLT Pfnd3d111DdiVideoprocessorblt;

HRESULT Pfnd3d111DdiVideoprocessorblt(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11_1DDI_HVIDEOPROCESSOR unnamedParam2,
  D3D11_1DDI_HVIDEOPROCESSOROUTPUTVIEW unnamedParam3,
  UINT unnamedParam4,
  UINT unnamedParam5,
  const D3D11_1DDI_VIDEO_PROCESSOR_STREAM *unnamedParam6
)
{...}

Paramètres

unnamedParam1

hDevice [in]

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

hVideoProcessor [in]

Handle de l’objet de processeur vidéo qui a été créé via un appel à la fonction CreateVideoProcessor .

unnamedParam3

hOutputView [in]

Handle de la ressource pour la vue de sortie du processeur vidéo. Ce handle a été créé via un appel à la fonction CreateVideoProcessorOutputView .

unnamedParam4

OutputFrame [in]

Index de base zéro de l’image vidéo de sortie.

unnamedParam5

StreamCount [in]

Nombre de flux d’entrée à traiter dans le tableau référencé par le paramètre pStream .

Note La valeur maximale de ce paramètre est spécifiée par le membre MaxStreamStates de la structure D3D11_1DDI_VIDEO_PROCESSOR_CAPS . Le nombre maximal de flux pouvant être activés à la fois est indiqué dans le membre MaxInputStreams de cette structure.

unnamedParam6

pStream [in]

Pointeur vers un tableau de structures D3D11_1DDI_VIDEO_PROCESSOR_STREAM qui contiennent des informations sur les flux d’entrée.

Valeur retournée

VideoProcessorBlt retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	L’opération de traitement vidéo s’est terminée avec succès.
E_OUTOFMEMORY	La mémoire n’était pas disponible pour terminer l’opération.

Remarques

VideoProcessorBlt effectue tout le traitement vidéo en fonction des états de flux et des états de transfert de bloc de bits (bitblt) qui ont été définis précédemment.

Le runtime Microsoft Direct3D effectue la validation des données suivante avant d’appeler la fonction VideoProcessorBlt du pilote :

Les structures RECT d’entrée et de sortie peuvent être ajustées si les rectangles ne sont pas alignés correctement en fonction des exigences du format.
Si le processeur vidéo a été activé pour produire des exemples stéréo, la vue de sortie doit contenir un tableau de textures de deux éléments. En outre, au moins un flux stéréo doit être spécifié.
Si le processeur vidéo a été désactivé de la production d’échantillons stéréo, la vue de sortie doit contenir un seul élément. En outre, le format stéréo ne peut pas être configuré comme D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO.

Note Un processeur vidéo est activé ou désactivé pour la production d’exemples stéréo via un appel à VideoProcessorSetOutputStereoMode.
Chaque flux d’entrée est spécifié via une structure D3D11_1DDI_VIDEO_PROCESSOR_STREAM . Si le format stéréo du flux d’entrée est configuré pour être D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, le membre pInputSurfaceRight ne doit pas avoir la valeur NULL. Sinon, pInputSurfaceRight doit avoir la valeur NULL.
Note Le format stéréo d’un flux d’entrée est configuré via un appel à VideoProcessorSetStreamStereoFormat.

Si plusieurs flux d’entrée sont activés et que le processeur vidéo est activé pour produire une sortie stéréo, il est possible que l’un des flux d’entrée soit un exemple mono.

Note Cette fonction n’honore pas un prédicat D3D11 qui a peut-être été défini.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)