PFND3D11_1DDI_VIDEOPROCESSORBLT función de devolución de llamada (d3d10umddi.h)

Artículo
08/07/2023

Realiza una operación de procesamiento de vídeo en una o varias muestras de entrada y escribe el resultado en una superficie de Direct3D.

Sintaxis

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

Parámetros

unnamedParam1

hDevice [in]

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

hVideoProcessor [in]

Identificador del objeto de procesador de vídeo que se creó a través de una llamada a la función CreateVideoProcessor .

unnamedParam3

hOutputView [in]

Identificador del recurso para la vista de salida del procesador de vídeo. Este identificador se creó mediante una llamada a la función CreateVideoProcessorOutputView .

unnamedParam4

OutputFrame [in]

Índice de base cero del fotograma de vídeo de salida.

unnamedParam5

StreamCount [in]

Número de flujos de entrada que se van a procesar en la matriz a la que hace referencia el parámetro pStream .

Nota El valor máximo de este parámetro lo especifica el miembro MaxStreamStates de la estructura D3D11_1DDI_VIDEO_PROCESSOR_CAPS . El número máximo de secuencias que se pueden habilitar a la vez se da en el miembro MaxInputStreams de esa estructura.

unnamedParam6

pStream [in]

Puntero a una matriz de estructuras de D3D11_1DDI_VIDEO_PROCESSOR_STREAM que contienen información sobre los flujos de entrada.

Valor devuelto

VideoProcessorBlt devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	La operación de procesamiento de vídeo se completó correctamente.
E_OUTOFMEMORY	La memoria no estaba disponible para completar la operación.

Comentarios

VideoProcessorBlt realiza todo el procesamiento de vídeo en función de los estados de secuencia y los estados de transferencia de bloques de bits (bitblt) que se han establecido anteriormente.

El tiempo de ejecución de Microsoft Direct3D realiza la siguiente validación de datos antes de llamar a la función VideoProcessorBlt del controlador:

Las estructuras RECT de entrada y salida se pueden ajustar si los rectángulos no están alineados correctamente según los requisitos del formato.
Si el procesador de vídeo se ha habilitado para generar muestras estéreo, la vista de salida debe contener una matriz de texturas de dos elementos. Además, debe especificarse al menos una secuencia estéreo.
Si el procesador de vídeo se ha deshabilitado para producir muestras estéreo, la vista de salida debe contener un solo elemento. Además, el formato estéreo no se puede configurar como D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO.

Nota Un procesador de vídeo está habilitado o deshabilitado para la producción de muestras estéreo a través de una llamada a VideoProcessorSetOutputStereoMode.
Cada flujo de entrada se especifica a través de una estructura de D3D11_1DDI_VIDEO_PROCESSOR_STREAM . Si el formato estéreo del flujo de entrada está configurado para ser D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, el miembro pInputSurfaceRight no debe establecerse en NULL. De lo contrario, pInputSurfaceRight debe establecerse en NULL.
Nota El formato estéreo de una secuencia de entrada se configura a través de una llamada a VideoProcessorSetStreamStereoFormat.

Si hay varias secuencias de entrada habilitadas y el procesador de vídeo está habilitado para generar una salida estéreo, es posible que una de las secuencias de entrada sea una muestra mono.

Nota Esta función no respeta un predicado D3D11 que se puede haber establecido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Escritorio
Encabezado	d3d10umddi.h (incluya D3d10umddi.h)