PFND3DDDI_DECODEEXTENSIONEXECUTE 콜백 함수(d3dumddi.h)
DecodeExtensionExecute 함수는 지정된 DXVA(DirectX Video Accelerator) 비표준 디코딩 확장 디바이스를 사용하여 디코딩 작업을 수행합니다.
통사론
PFND3DDDI_DECODEEXTENSIONEXECUTE Pfnd3dddiDecodeextensionexecute;
HRESULT Pfnd3dddiDecodeextensionexecute(
HANDLE hDevice,
const D3DDDIARG_DECODEEXTENSIONEXECUTE *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in, out]
수행할 DXVA 디코딩 작업을 설명하는 D3DDDIARG_DECODEEXTENSIONEXECUTE 구조체에 대한 포인터입니다.
반환 값
DecodeExtensionExecute 다음 값 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| S_OK | DirectX VA 디코딩 작업이 성공적으로 수행되었습니다. |
| E_OUTOFMEMORY | DecodeExtensionExecute가 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
발언
UMD(사용자 모드 표시 드라이버)는 표준 디코드 형식(즉, 표준 디코드 GUID)에 대한 확장을 지원하기 위해 DecodeExtensionExecute 함수를 구현할 수 있습니다. 이러한 비표준 디코드 형식은 암호화 및 기타 향상된 기능을 구성하는 데 유용합니다.
DecodeExtensionExecute DirectX VA 2.0 디코더에 비표준 확장이 필요할 때 호출됩니다.
이러한 비표준 확장이 필요할 수 있는 DirectX VA 1.0 디코더와의 호환성을 위해 DirectX VA 1.0 디코더가 4보다 큰 bDXVA_Func 값이 D3DDDIARG_DECODEEXTENSIONEXECUTE 구조의 함수 멤버 중 가장 중요한 8비트에서 설정되는 실행 호출을 수행할 때마다 decodeExtensionExecute 호출됩니다. DecodeExtensionExecute DirectX VA 1.0 디코더가 DXVA_QUERYORREPLYFUNCFLAG_DECODER_PROBE_QUERY(0xFFFFF1) 또는 DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY(0xFFFFF5) 플래그 이외의 모든 DXVA_ConfigQueryOrReplyFunc 플래그가 가장 중요한 24비트 함수설정되는 구성 호출을 수행할 때마다 호출됩니다. 함수비트 설정의 의미에 대한 자세한 내용은 DXVA_ConfigQueryOrReplyFlag 및 DXVA_ConfigQueryorReplyFunc 변수 및 bDXVA_Func 변수 항목을 참조하세요.
DXVA_QUERYORREPLYFUNCFLAG_DECODER_LOCK_QUERY 전에 이러한 구성 호출을 수행할 수 있는 DirectX VA 1.0 디코더와의 호환성 문제로 인해 디코더가 디코딩 디바이스를 만들기 전에 이러한 구성 호출을 수행할 수도 있습니다. 디코딩 디바이스를 만들기 전에 이러한 구성 호출이 수행되면 pData 매개 변수가 가리키는 D3DDDIARG_DECODEEXTENSIONEXECUTE 구조체의 hDecode 멤버가 NULL로 설정됩니다. 이 경우 드라이버가 디코딩 디바이스와 관계없이 상황을 지원할 수 없는 경우 오류(예: E_FAIL)를 반환해야 할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | d3dumddi.h(D3dumddi.h 포함) |