PFND3D11_1DDI_VIDEOPROCESSORBLT função de retorno de chamada (d3d10umddi.h)

Artigo
03/08/2023

Executa uma operação de processamento de vídeo em um ou mais exemplos de entrada e grava o resultado em uma superfície Direct3D.

Sintaxe

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]

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

hVideoProcessor [in]

Um identificador para o objeto processador de vídeo que foi criado por meio de uma chamada para a função CreateVideoProcessor .

unnamedParam3

hOutputView [in]

Um identificador para o recurso para a exibição de saída do processador de vídeo. Esse identificador foi criado por meio de uma chamada para a função CreateVideoProcessorOutputView .

unnamedParam4

OutputFrame [in]

O índice baseado em zero do quadro de vídeo de saída.

unnamedParam5

StreamCount [in]

O número de fluxos de entrada a serem processados na matriz referenciada pelo parâmetro pStream .

Nota O valor máximo desse parâmetro é especificado pelo membro MaxStreamStates da estrutura D3D11_1DDI_VIDEO_PROCESSOR_CAPS . O número máximo de fluxos que podem ser habilitados ao mesmo tempo é fornecido no membro MaxInputStreams dessa estrutura.

unnamedParam6

pStream [in]

Um ponteiro para uma matriz de estruturas de D3D11_1DDI_VIDEO_PROCESSOR_STREAM que contêm informações sobre os fluxos de entrada.

Retornar valor

VideoProcessorBlt retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	A operação de processamento de vídeo foi concluída com êxito.
E_OUTOFMEMORY	A memória não estava disponível para concluir a operação.

Comentários

O VideoProcessorBlt executa todo o processamento de vídeo com base nos estados de fluxo e nos estados de transferência de bloco de bits (bitblt) que foram definidos anteriormente.

O runtime do Microsoft Direct3D executa a seguinte validação de dados antes de chamar a função VideoProcessorBlt do driver:

As estruturas RECT de entrada e saída poderão ser ajustadas se os retângulos não estiverem alinhados corretamente de acordo com os requisitos do formato.
Se o processador de vídeo tiver sido habilitado para produzir amostras estéreo, a exibição de saída deverá conter uma matriz de textura de dois elementos. Além disso, pelo menos um fluxo estéreo deve ser especificado.
Se o processador de vídeo tiver sido desabilitado da produção de amostras estéreo, a exibição de saída deverá conter um único elemento. Além disso, o formato estéreo não pode ser configurado como D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO.

Nota Um processador de vídeo está habilitado ou desabilitado para a produção de exemplos estéreo por meio de uma chamada para VideoProcessorSetOutputStereoMode.
Cada fluxo de entrada é especificado por meio de uma estrutura D3D11_1DDI_VIDEO_PROCESSOR_STREAM . Se o formato estéreo do fluxo de entrada estiver configurado para ser D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, o membro pInputSurfaceRight não deverá ser definido como NULL. Caso contrário, o pInputSurfaceRight deverá ser definido como NULL.
Nota O formato estéreo para um fluxo de entrada é configurado por meio de uma chamada para VideoProcessorSetStreamStereoFormat.

Se vários fluxos de entrada estiverem habilitados e o processador de vídeo estiver habilitado para produzir saída estéreo, é possível que um dos fluxos de entrada possa ser um exemplo mono.

Nota Essa função não respeita um predicado D3D11 que pode ter sido definido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)