Compartir a través de

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

  • Artículo

Inicia una operación de descodificación para descodificar un fotograma de vídeo.

Sintaxis

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

Parámetros

pDecoder

Puntero a la interfaz ID3D11VideoDecoder . Para obtener este puntero, llame a ID3D11VideoDevice::CreateVideoDecoder.

pView

Puntero a una interfaz ID3D11VideoDecoderOutputView . Esta interfaz describe el recurso que recibirá el marco descodificado. Para obtener este puntero, llame a ID3D11VideoDevice::CreateVideoDecoderOutputView.

ContentKeySize

Tamaño de la clave de contenido especificada en pContentKey. Si pContentKey es NULL, establezca ContentKeySize en cero.

pContentKey

Puntero opcional a una clave de contenido que se usó para cifrar los datos de fotogramas. Si no se usó ninguna clave de contenido, establezca este parámetro en NULL. Si el autor de la llamada proporciona una clave de contenido, el autor de la llamada debe usar la clave de sesión para cifrar la clave de contenido.

NumComponentHistograms

Número de componentes para los que se va a registrar un histograma. Use D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM para comprobar si hay soporte técnico. Use cero cuando no grabe histogramas o cuando no se admita la característica. Especificar menos componentes de los que están en el formato implica que esos componentes no tienen habilitada la grabación de histogramas. El número máximo de componentes se define como D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS.

pHistogramOffsets

Matriz de ubicaciones de desplazamiento del búfer inicial dentro de la matriz paralela ppHistogramBuffers . Use D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT para indexar la matriz. Si no se solicita un componente, especifique un desplazamiento de cero. Los desplazamientos deben estar alineados con 256 bytes.

ppHistogramBuffers

Matriz de búferes de destino para que el hardware escriba el histograma de componentes. Use D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT para indexar la matriz. Establezca este parámetro en nullptr cuando el histograma del componente está deshabilitado o no admitido

Valor devuelto

Devuelve S_OK si se ejecuta correctamente.

Comentarios

Se permiten las siguientes marcas de D3D11_RESOURCE_MISC al asignar recursos para descodificar histogramas 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

No se permiten todas las demás marcas de D3D11_RESOURCE_MISC.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Servidor mínimo compatible compilación 20348 de Windows 10
Encabezado d3d11_4.h