ID3D11VideoContext3::D ecoderBeginFrame1 メソッド (d3d11_4.h)

ビデオ フレームをデコードするデコード操作を開始します。

構文

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

パラメーター

pDecoder

ID3D11VideoDecoder インターフェイスへのポインター。 このポインターを取得するには、ID3D11VideoDevice::CreateVideoDecoder を呼び出します

pView

ID3D11VideoDecoderOutputView インターフェイスへのポインター。 このインターフェイスでは、デコードされたフレームを受け取るリソースについて説明します。 このポインターを取得するには、 ID3D11VideoDevice::CreateVideoDecoderOutputView を呼び出します。

ContentKeySize

pContentKey で指定されたコンテンツ キーのサイズ。 pContentKey が NULL の場合は、ContentKeySize を 0 に設定します。

pContentKey

フレーム データの暗号化に使用されたコンテンツ キーへのオプションのポインター。 コンテンツ キーが使用されていない場合は、このパラメーターを NULL に設定します。 呼び出し元がコンテンツ キーを提供する場合、呼び出し元はセッション キーを使用してコンテンツ キーを暗号化する必要があります。

NumComponentHistograms

ヒストグラムを記録するコンポーネントの数。 D3D11_FEATURE_VIDEO_DECODE_HISTOGRAMを使用して、サポートをチェックします。 ヒストグラムを記録しない場合、または機能がサポートされていない場合は、0 を使用します。 形式よりも少ないコンポーネントを指定すると、それらのコンポーネントでヒストグラムの記録が有効になっていないことを意味します。 コンポーネントの最大数は 、D3D11_4_VIDEO_DECODER_MAX_HISTOGRAM_COMPONENTSとして定義されます。

pHistogramOffsets

ppHistogramBuffers 並列配列内の開始バッファー オフセット位置の配列。 D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENTを使用して配列のインデックスを作成します。 コンポーネントが要求されない場合は、0 のオフセットを指定します。 オフセットは 256 バイトアラインされている必要があります。

ppHistogramBuffers

コンポーネント ヒストグラムを書き込むハードウェアのターゲット バッファーの配列。 D3D11_VIDEO_DECODE_HISTOGRAM_COMPONENTを使用して配列のインデックスを作成します。 コンポーネント ヒストグラムが無効またはサポートされていない場合は、このパラメーターを nullptr に設定します

戻り値

成功した場合 は、S_OK を返します。

注釈

次の D3D11_RESOURCE_MISC フラグは、ビデオ デコード ヒストグラムのリソースを割り当てるときに許可されます。

• 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

他のすべてのD3D11_RESOURCE_MISCフラグは許可されません。

要件

要件	値
サポートされている最小のクライアント	Windows 10 ビルド 20348
サポートされている最小のサーバー	Windows 10 ビルド 20348
Header	d3d11_4.h