| Date | Change |
|---|---|
| 05/29/2019 | Initial draft |
| Issue Number | Description |
|---|---|
This feature adds optional protected resource support to D3D12 Video operations to WDDM 2.7. Protected resources for Cross-API sharing and Graphics/Compute/Operations was introduced in WDDM 2.4, but these resources were not yet permitted for video operations until now.
Each video operation adds a new capability check with a support flag so drivers can indicate if that operation supports protected resources . Indicating support means that operation can read/write protected resources and supports Cross-API sharing if the resource type supports it. Operation support for protected resources is orthogonal to other operation capabilities with the exception of decode profile and interlace type for decode. Once protected resource support is reported, it must be supported by all the existing non-protected resource capabilities of that operation. For example, if Decode reports protected resource support and reports decode histogram support for a given format, the decoder must support decode histogram for both non-protected and protected resources.
Creation methods are modified to take an optional D3D12DDI_HPROTECTEDRESOURCESESSION instance. Drivers are given this parameter at object creation time to inform setup and allocations. Further, the memory budget checks are revised to indicate whether or not the operation will use protected resources. When the parameter is non-NULL, this indicates that the operation will write to protected resources. To write to an unprotected resource, the operation object must be recreated.
Decoder and motion estimation references must be protected resources when the output is a protected resource. Video processing may read from a combination of protected and unprotected resources when writing to a protected resource.
Before recording one ore more operations that writes to a protected resource, PFND3D12DDI_SETPROTECTEDRESOURCESESSION_0030 must be called with a non-NULL protected resource session. Calling PFND3D12DDI_SETPROTECTEDRESOURCESESSION_0030 with NULL is required before recording one or more operations that write to non-protected resources.
NOTE: Motion Estimation initially shipped with WDDM 2.6 requiring support for Protected Resources, but this was withdrawn late in the release. This feature is reintroducing optional protected resource support for motion estimation.
Below details the DDI changes that result from this feature. The _0072 postfix is used to indicate new items in the DDI, but this number is based on the current usermode DDI when the feature is submitted. Therefore it may be _0073, _0074 etc. in the actual header.
PFND3D12DDI_SETPROTECTEDRESOURCESESSION_0030 has been in video command list DDI tables for some time. They are not listed as additions below.
Existing support flags for video decode and video processing are extended to indicated protected resource support.
Motion estimation previously introduced creation and size data parameters for protected resource support. The optional capability check is introduced in WDDM 2.7. The runtime assumes protected resources are not supported on WDDM 2.6 drivers.
//----------------------------------------------------------------------------------------------------------------------------------// D3D12 Extended Feature Video// Version: D3D12DDI_FEATURE_VERSION_VIDEO_0072// Usermode DDI Min Version: D3D12DDI_SUPPORTED_0043#define D3D12DDI_FEATURE_VERSION_VIDEO_0072_0 16utypedefenumD3D12DDICAPS_TYPE_VIDEO_0020{/* Pre-existing values omitted for clarity */D3D12DDICAPS_TYPE_VIDEO_0072_DECODE_PROTECTED_RESOURCES=28,D3D12DDICAPS_TYPE_VIDEO_0072_PROCESS_PROTECTED_RESOURCES=29,D3D12DDICAPS_TYPE_VIDEO_0072_MOTION_ESTIMATOR_PROTECTED_RESOURCES=30,}D3D12DDICAPS_TYPE_VIDEO_0020;typedefenumD3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072{D3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAG_0072_NONE=0,D3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAG_0072_SUPPORTED=0x1,}D3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072;DEFINE_ENUM_FLAG_OPERATORS(D3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072);// D3D12DDICAPS_TYPE_VIDEO_0072_DECODE_PROTECTED_RESOURCES// *pInfo = nullptr// pData = D3D12DDI_VIDEO_DECODE_PROTECTED_RESOURCES_DATA_0072// DataSize = sizeof(D3D12DDI_VIDEO_DECODE_PROTECTED_RESOURCES_DATA_0072)typedefstructD3D12DDI_VIDEO_DECODE_PROTECTED_RESOURCES_DATA_0072{UINTNodeIndex;// inputD3D12DDI_VIDEO_DECODE_CONFIGURATION_0020Configuration;// inputD3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072SupportFlags;// output}D3D12DDI_VIDEO_DECODE_PROTECTED_RESOURCES_DATA_0072;// D3D12DDICAPS_TYPE_VIDEO_0072_PROCESS_PROTECTED_RESOURCES// *pInfo = nullptr// pData = D3D12DDI_VIDEO_PROCESS_PROTECTED_RESOURCES_DATA_0072// DataSize = sizeof(D3D12DDI_VIDEO_PROCESS_PROTECTED_RESOURCES_DATA_0072)typedefstructD3D12DDI_VIDEO_PROCESS_PROTECTED_RESOURCES_DATA_0072{UINTNodeIndex;// inputD3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072SupportFlags;// output}D3D12DDI_VIDEO_PROCESS_PROTECTED_RESOURCES_DATA_0072;// D3D12DDICAPS_TYPE_VIDEO_0072_MOTION_ESTIMATOR_PROTECTED_RESOURCES// *pInfo = nullptr// pData = D3D12DDI_VIDEO_MOTION_ESTIMATOR_PROTECTED_RESOURCES_DATA_0072// DataSize = sizeof(D3D12DDI_VIDEO_MOTION_ESTIMATOR_PROTECTED_RESOURCES_DATA_0072)typedefstructD3D12DDI_VIDEO_MOTION_ESTIMATOR_PROTECTED_RESOURCES_DATA_0072{UINTNodeIndex;// inputD3D12DDI_VIDEO_PROTECTED_RESOURCE_SUPPORT_FLAGS_0072SupportFlags;// output}D3D12DDI_VIDEO_MOTION_ESTIMATOR_PROTECTED_RESOURCES_DATA_0072;// D3D12DDICAPS_TYPE_VIDEO_0032_DECODER_HEAP_SIZE// *pInfo = nullptr// pData = D3D12DDI_VIDEO_DECODER_HEAP_SIZE_DATA_0072// DataSize = sizeof(D3D12DDI_VIDEO_DECODER_HEAP_SIZE_DATA_0072)typedefstructD3D12DDI_VIDEO_DECODER_HEAP_SIZE_DATA_0072{D3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0033VideoDecoderHeapDesc;// inputBOOLProtected;// inputUINT64MemoryPoolL0Size;// outputUINT64MemoryPoolL1Size;// output}D3D12DDI_VIDEO_DECODER_HEAP_SIZE_DATA_0072;// D3D12DDICAPS_TYPE_VIDEO_0032_PROCESSOR_SIZE// *pInfo = nullptr// pData = D3D12DDI_VIDEO_PROCESSOR_SIZE_DATA_0072// DataSize = sizeof(D3D12DDI_VIDEO_PROCESSOR_SIZE_DATA_0072)typedefstructD3D12DDI_VIDEO_PROCESSOR_SIZE_DATA_0072{D3D12DDIARG_CREATE_VIDEO_PROCESSOR_0043VideoProcessorDesc;// inputBOOLProtected;// inputUINT64MemoryPoolL0Size;// outputUINT64MemoryPoolL1Size;// output}D3D12DDI_VIDEO_PROCESSOR_SIZE_DATA_0072;typedefSIZE_T(APIENTRY*PFND3D12DDI_CALCPRIVATEVIDEODECODERSIZE_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_DECODER_0032*pArgs,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession);typedefHRESULT(APIENTRY*PFND3D12DDI_CREATEVIDEODECODER_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_DECODER_0032*pArgs,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession,D3D12DDI_HVIDEODECODER_0020hDrvVideoDecoder);typedefSIZE_T(APIENTRY*PFND3D12DDI_CALCPRIVATEVIDEODECODERHEAPSIZE_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0033*pArgs,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession);typedefHRESULT(APIENTRY*PFND3D12DDI_CREATEVIDEODECODERHEAP_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_DECODER_HEAP_0033*,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession,D3D12DDI_HVIDEODECODERHEAP_0032hDrvVideoDecoderHeap);typedefSIZE_T(APIENTRY*PFND3D12DDI_CALCPRIVATEVIDEOPROCESSORSIZE_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_PROCESSOR_0043*pArgs,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession);typedefHRESULT(APIENTRY*PFND3D12DDI_CREATEVIDEOPROCESSOR_0072)(D3D12DDI_HDEVICEhDrvDevice,_In_CONSTD3D12DDIARG_CREATE_VIDEO_PROCESSOR_0043*pArgs,_In_opt_D3D12DDI_HPROTECTEDRESOURCESESSION_0030hDrvProtectedResourceSession,D3D12DDI_HVIDEOPROCESSOR_0020hDrvVideoProcessor);// D3D12DDI_TABLE_TYPE_0020_DEVICE_VIDEOtypedefstructD3D12DDI_DEVICE_FUNCS_VIDEO_0072{PFND3D12DDI_VIDEO_GETCAPSpfnGetCaps;PFND3D12DDI_CALCPRIVATEVIDEODECODERSIZE_0072pfnCalcPrivateVideoDecoderSize;PFND3D12DDI_CREATEVIDEODECODER_0072pfnCreateVideoDecoder;PFND3D12DDI_DESTROYVIDEODECODER_0021pfnDestroyVideoDecoder;PFND3D12DDI_CALCPRIVATEVIDEODECODERHEAPSIZE_0072pfnCalcPrivateVideoDecoderHeapSize;PFND3D12DDI_CREATEVIDEODECODERHEAP_0072pfnCreateVideoDecoderHeap;PFND3D12DDI_DESTROYVIDEODECODERHEAP_0032pfnDestroyVideoDecoderHeap;PFND3D12DDI_CALCPRIVATEVIDEOPROCESSORSIZE_0072pfnCalcPrivateVideoProcessorSize;PFND3D12DDI_CREATEVIDEOPROCESSOR_0072pfnCreateVideoProcessor;PFND3D12DDI_DESTROYVIDEOPROCESSOR_0021pfnDestroyVideoProcessor;PFND3D12DDI_CALCPRIVATEVIDEOMOTIONESTIMATORSIZE_0060pfnCalcPrivateVideoMotionEstimatorSize;PFND3D12DDI_CREATEVIDEOMOTIONESTIMATOR_0060pfnCreateVideoMotionEstimator;PFND3D12DDI_DESTROYVIDEOMOTIONESTIMATOR_0053pfnDestroyVideoMotionEstimator;PFND3D12DDI_CALCPRIVATEVIDEOMOTIONVECTORHEAPSIZE_0060pfnCalcPrivateVideoMotionVectorHeapSize;PFND3D12DDI_CREATEVIDEOMOTIONVECTORHEAP_0060pfnCreateVideoMotionVectorHeap;PFND3D12DDI_DESTROYVIDEOMOTIONVECTORHEAP_0053pfnDestroyVideoMotionVectorHeap;PFND3D12DDI_CALCPRIVATEVIDEOEXTENSIONCOMMANDSIZE_0061pfnCalcPrivateVideoExtensionCommandSize;PFND3D12DDI_CREATEVIDEOEXTENSIONCOMMAND_0063pfnCreateVideoExtensionCommand;PFND3D12DDI_DESTROYVIDEOEXTENSIONCOMMAND_0063pfnDestroyVideoExtensionCommand;}D3D12DDI_DEVICE_FUNCS_VIDEO_0072;