PFND3D11_1DDI_VIDEOPROCESSORBLT Rückruffunktion (d3d10umddi.h)

Artikel
08/07/2023

Führt einen Videoverarbeitungsvorgang für mindestens ein Eingabebeispiel aus und schreibt das Ergebnis in eine Direct3D-Oberfläche.

Syntax

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
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

hVideoProcessor [in]

Ein Handle für das Videoprozessorobjekt, das durch einen Aufruf der CreateVideoProcessor-Funktion erstellt wurde.

unnamedParam3

hOutputView [in]

Ein Handle für die Ressource für die Ausgabeansicht des Videoprozessors. Dieses Handle wurde durch einen Aufruf der Funktion CreateVideoProcessorOutputView erstellt.

unnamedParam4

OutputFrame [in]

Der nullbasierte Index des Ausgabevideoframes.

unnamedParam5

StreamCount [in]

Die Anzahl der Zu verarbeitenden Eingabedatenströme in dem Array, auf das vom pStream-Parameter verwiesen wird.

Hinweis Der Maximalwert dieses Parameters wird vom MaxStreamStates-Member der D3D11_1DDI_VIDEO_PROCESSOR_CAPS-Struktur angegeben. Die maximale Anzahl von Streams, die gleichzeitig aktiviert werden können, wird im MaxInputStreams-Member dieser Struktur angegeben.

unnamedParam6

pStream [in]

Ein Zeiger auf ein Array von D3D11_1DDI_VIDEO_PROCESSOR_STREAM Strukturen, die Informationen zu den Eingabedatenströmen enthalten.

Rückgabewert

VideoProcessorBlt gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Der Videoverarbeitungsvorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY	Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen.

Hinweise

VideoProcessorBlt führt die gesamte Videoverarbeitung basierend auf den zuvor festgelegten Streamzuständen und Bitblockübertragungszuständen (Bitblt) durch.

Die Microsoft Direct3D-Runtime führt die folgende Datenüberprüfung durch, bevor die VideoProcessorBlt-Funktion des Treibers aufgerufen wird:

Die Ein- und Ausgabe-RECT-Strukturen können angepasst werden, wenn die Rechtecke nicht ordnungsgemäß gemäß den Anforderungen des Formats ausgerichtet sind.
Wenn der Videoprozessor zum Erstellen von Stereobeispielen aktiviert wurde, muss die Ausgabeansicht ein Texturarray aus zwei Elementen enthalten. Außerdem muss mindestens ein Stereostream angegeben werden.
Wenn der Videoprozessor für die Erstellung von Stereobeispielen deaktiviert wurde, muss die Ausgabeansicht ein einzelnes Element enthalten. Außerdem kann das Stereoformat nicht als D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO konfiguriert werden.

Hinweis Ein Videoprozessor ist für die Produktion von Stereobeispielen über einen Aufruf von VideoProcessorSetOutputStereoMode aktiviert oder deaktiviert.
Jeder Eingabedatenstrom wird über eine D3D11_1DDI_VIDEO_PROCESSOR_STREAM-Struktur angegeben. Wenn das Stereoformat des Eingabestreams für D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE konfiguriert ist, darf der pInputSurfaceRight-Member nicht auf NULL festgelegt werden. Andernfalls muss pInputSurfaceRight auf NULL festgelegt werden.
Hinweis Das Stereoformat für einen Eingabestream wird durch einen Aufruf von VideoProcessorSetStreamStereoFormat konfiguriert.

Wenn mehrere Eingabedatenströme aktiviert sind und der Videoprozessor für die Stereoausgabe aktiviert ist, kann es sich bei einem der Eingabedatenströme um ein Monobeispiel handelt.

Hinweis Diese Funktion berücksichtigt kein D3D11-Prädikat, das möglicherweise festgelegt 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)