PFND3D11_1DDI_VIDEOPROCESSORBLT fonction de rappel (d3d10umddi.h)

Article
02/06/2025

Effectue une opération de traitement vidéo sur un ou plusieurs exemples d’entrée et écrit le résultat dans 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 processeur vidéo créé par le biais d’un appel à la fonction createVideoProcessor .

unnamedParam3

hOutputView [in]

Handle vers 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.

Remarque 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 donné dans la MaxInputStreams membre 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 de retour

VideoProcessorBlt retourne l’une des valeurs suivantes :

Retourner le code	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

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

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

Les structures d’entrée et de sortie RECT 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 échantillons 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é pour produire des é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.

Remarque Un processeur vidéo est activé ou désactivé pour la production d’échantillons 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, le pInputSurfaceRight doit avoir la valeur NULL.
Remarque 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.

Remarque Cette fonction ne respecte pas un prédicat D3D11 qui a peut-être été défini.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	d3d10umddi.h (include D3d10umddi.h)