Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Specifies whether and how a Direct3D 12 video encoder returns reconstructed pictures. This enumeration is used with the CODECAPI_AVEncVideoD3D12ReconstructedPictureOutputMode property.
Syntax
typedef enum eAVEncVideoD3D12ReconstructedPictureOutputMode {
eAVEncVideoEncodeD3D12ReconstructedPictureMode_None = 0,
eAVEncVideoEncodeD3D12ReconstructedPictureMode_Copy = 1,
eAVEncVideoEncodeD3D12ReconstructedPictureMode_Shared = 2
} ;
Constants
eAVEncVideoEncodeD3D12ReconstructedPictureMode_NoneValue: 0 The encoder does not return a Direct3D 12 reconstructed picture. This is the default value. |
eAVEncVideoEncodeD3D12ReconstructedPictureMode_CopyValue: 1 The encoder returns a copy of the Direct3D 12 reconstructed picture. The returned resource is independent of the encoder's internal reference buffers. |
eAVEncVideoEncodeD3D12ReconstructedPictureMode_SharedValue: 2 The encoder returns the Direct3D 12 reconstructed picture that was written by the encoder, without making a copy. The application must not modify the returned resource because it may be used internally by the encoder as a reference frame for encoding future frames. |
Remarks
When this property is set to a value other than eAVEncVideoEncodeD3D12ReconstructedPictureMode_None, the encoder attaches the reconstructed picture to each output IMFSample as an IMFMediaBuffer using the MFSampleExtension_VideoEncodeD3D12ReconstructedPicture attribute.
The reconstructed picture is an ID3D12Resource wrapped in an IMFMediaBuffer. The resource contains a picture described by D3D12_RESOURCE_DESC. The returned resource has the same dimensions, with alignment, as the Direct3D 12 input surface to the encoder. The alignment is typically 16 pixels due to hardware constraints. If the actual width and height are smaller than the aligned dimensions, the application should interpret the top-left rectangular region as the active region.
Requirements
| Requirement | Value |
|---|---|
| Header | codecapi.h |