Método ID3D11VideoContext3::D ecoderBeginFrame1 (d3d11_4.h)

Inicia uma operação de decodificação para decodificar um quadro de vídeo.

Sintaxe

HRESULT DecoderBeginFrame1(
  ID3D11VideoDecoder           *pDecoder,
  ID3D11VideoDecoderOutputView *pView,
  UINT                         ContentKeySize,
  const void                   *pContentKey,
  UINT                         NumComponentHistograms,
  const UINT                   *pHistogramOffsets,
  ID3D11Buffer                 * const *ppHistogramBuffers
);

Parâmetros

pDecoder

Um ponteiro para a interface ID3D11VideoDecoder . Para obter esse ponteiro, chame ID3D11VideoDevice::CreateVideoDecoder

pView

Um ponteiro para uma interface ID3D11VideoDecoderOutputView . Essa interface descreve o recurso que receberá o quadro decodificado. Para obter esse ponteiro, chame ID3D11VideoDevice::CreateVideoDecoderOutputView.

ContentKeySize

O tamanho da chave de conteúdo especificada em pContentKey. Se pContentKey for NULL, defina ContentKeySize como zero.

pContentKey

Um ponteiro opcional para uma chave de conteúdo que foi usada para criptografar os dados de quadro. Se nenhuma chave de conteúdo tiver sido usada, defina esse parâmetro como NULL. Se o chamador fornecer uma chave de conteúdo, o chamador deverá usar a chave de sessão para criptografar a chave de conteúdo.

NumComponentHistograms

O número de componentes para os qual gravar histogramas. Use D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM para marcar para obter suporte. Use zero quando não estiver gravando histogramas ou quando não houver suporte para o recurso. Especificar menos componentes do que estão no formato implica que esses componentes não têm a gravação de histograma habilitada. O número máximo de componentes é definido como D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS.

pHistogramOffsets

Uma matriz de locais de deslocamento de buffer inicial dentro da matriz paralela ppHistogramBuffers . Use D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT para indexar a matriz. Se um componente não for solicitado, especifique um deslocamento de zero. Os deslocamentos devem estar alinhados a 256 bytes.

ppHistogramBuffers

Uma matriz de buffers de destino para hardware para gravar o histograma de componentes. Use D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT para indexar a matriz. Defina esse parâmetro como nullptr quando o histograma do componente estiver desabilitado ou sem suporte

Retornar valor

Retorna S_OK se tiver êxito.

Comentários

Os sinalizadores de D3D11_RESOURCE_MISC a seguir são permitidos ao alocar recursos para histogramas de decodificação de vídeo.

• D3D11_RESOURCE_MISC_SHARED
• D3D11_RESOURCE_MISC_DRAWINDIRECT_ARGS
• D3D11_RESOURCE_MISC_BUFFER_ALLOW_RAW_VIEWS
• D3D11_RESOURCE_MISC_BUFFER_STRUCTURED
• D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX
• D3D11_RESOURCE_MISC_SHARED_NTHANDLE
• D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE
• D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER

Todos os outros sinalizadores de D3D11_RESOURCE_MISC não são permitidos.

Requisitos