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
머리글	d3d11_4.h