Metodo ID3D11VideoContext3::D ecoderBeginFrame1 (d3d11_4.h)

Avvia un'operazione di decodifica per decodificare un fotogramma video.

Sintassi

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

Parametri

pDecoder

Puntatore all'interfaccia ID3D11VideoDecoder . Per ottenere questo puntatore, chiama ID3D11VideoDevice::CreateVideoDecoder

pView

Puntatore a un'interfaccia ID3D11VideoDecoderOutputView . Questa interfaccia descrive la risorsa che riceverà il frame decodificato. Per ottenere questo puntatore, chiama ID3D11VideoDevice::CreateVideoDecoderOutputView.

ContentKeySize

Dimensioni della chiave simmetrica specificata in pContentKey. Se pContentKey è NULL, impostare ContentKeySize su zero.

pContentKey

Puntatore facoltativo a una chiave simmetrica usata per crittografare i dati dei frame. Se non è stata usata alcuna chiave simmetrica, impostare questo parametro su NULL. Se il chiamante fornisce una chiave simmetrica, il chiamante deve usare la chiave di sessione per crittografare la chiave simmetrica.

NumComponentHistograms

Numero di componenti per cui registrare un istogramma. Usare D3D11_FEATURE_VIDEO_DECODE_HISTOGRAM per verificare la disponibilità del supporto. Usa zero quando non registra istogrammi o quando la funzionalità non è supportata. Se si specifica un numero inferiore di componenti rispetto a quelli nel formato, tali componenti non hanno la registrazione istogramma abilitata. Il numero massimo di componenti viene definito come D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTS.

pHistogramOffsets

Matrice di posizioni di offset del buffer iniziale all'interno della matrice parallela ppHistogramBuffers . Usare D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT per indicizzare la matrice. Se non è richiesto alcun componente, specificare un offset pari a zero. Gli offset devono essere allineati a 256 byte.

ppHistogramBuffers

Matrice di buffer di destinazione per l'hardware per scrivere l'istogramma dei componenti. Usare D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENT per indicizzare la matrice. Impostare questo parametro su nullptr quando l'istogramma del componente è disabilitato o non supportato

Valore restituito

Restituisce S_OK in caso di esito positivo.

Commenti

I flag di D3D11_RESOURCE_MISC seguenti sono consentiti durante l'allocazione delle risorse per la decodifica video degli istogrammi.

• 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

Tutti gli altri flag D3D11_RESOURCE_MISC non sono consentiti.

Requisiti