Abstract Direct3D11 NVENC encoder. Encapsulates common code used by native and interop implementations. More...

#include <src/nvenc/nvenc_d3d11.h>

Inheritance diagram for nvenc::nvenc_d3d11:

Collaboration diagram for nvenc::nvenc_d3d11:

Public Member Functions
ID3D11Texture2D *	get_input_texture () override=0
	Get input surface texture.

	nvenc_d3d11 (NV_ENC_DEVICE_TYPE device_type, ::nvenc::shared_dll dll)
	Initialize an NVENC session wrapper for D3D11 input textures.

Public Member Functions inherited from nvenc::nvenc_base
bool	create_encoder (const ::nvenc::nvenc_config &config, const video::config_t &client_config, const video::sunshine_colorspace_t &colorspace, platf::pix_fmt_e buffer_format) override
	Create the encoder.

void	destroy_encoder () override
	Destroy the encoder. Derived classes classes call it in the destructor.

::nvenc::nvenc_encoded_frame	encode_frame (uint64_t frame_index, bool force_idr) override
	Encode the next frame using platform-specific input surface.

bool	invalidate_ref_frames (uint64_t first_frame, uint64_t last_frame) override
	Perform reference frame invalidation (RFI) procedure.

	nvenc_base (const nvenc_base &)=delete

	nvenc_base (NV_ENC_DEVICE_TYPE device_type)

nvenc_base &	operator= (const nvenc_base &)=delete

Public Member Functions inherited from nvenc::nvenc_encoder
virtual bool	create_encoder (const nvenc_config &config, const video::config_t &client_config, const video::sunshine_colorspace_t &colorspace, platf::pix_fmt_e buffer_format)=0
	Create the encoder.

virtual nvenc_encoded_frame	encode_frame (std::uint64_t frame_index, bool force_idr)=0
	Encode the next frame using the platform-specific input surface.

virtual bool	invalidate_ref_frames (std::uint64_t first_frame, std::uint64_t last_frame)=0
	Invalidate reference frames in the requested range.

virtual	~nvenc_encoder ()=default
	Destroy the SDK-neutral encoder interface.

Public Member Functions inherited from nvenc::nvenc_d3d11_interface
	~nvenc_d3d11_interface () override=default
	Destroy the SDK-neutral Direct3D11 encoder interface.

Protected Member Functions
bool	init_library () override
	Required. Used for loading NvEnc library and setting `nvenc` variable with `NvEncodeAPICreateInstance()`. Called during `create_encoder()` if `nvenc` variable is not initialized.

bool	wait_for_async_event (uint32_t timeout_ms) override
	Optional. Override if you want to create encoder in async mode. In this case must also set `async_event_handle` variable.

Protected Member Functions inherited from nvenc::nvenc_base
virtual bool	create_and_register_input_buffer ()=0
	Required. Used for creating outside-facing input surface, registering this surface with `nvenc->nvEncRegisterResource()` and setting `registered_input_buffer` variable. Called during `create_encoder()`.

bool	nvenc_failed (NVENCSTATUS status)
	Check whether an NVENC API status represents failure.

virtual bool	synchronize_input_buffer ()
	Optional. Override if you must perform additional operations on the registered input surface in the beginning of `encode_frame()`. Typically used for interop copy.

Additional Inherited Members
Public Attributes inherited from nvenc::nvenc_base
Protected Attributes inherited from nvenc::nvenc_base
void *	async_event_handle = nullptr

void *	device = nullptr

const NV_ENC_DEVICE_TYPE	device_type
	NVENC device backend used by this encoder instance.

void *	encoder = nullptr
	Opaque NVENC encoder session handle returned by the driver.

struct {

NV_ENC_BUFFER_FORMAT buffer_format = NV_ENC_BUFFER_FORMAT_UNDEFINED

uint32_t height = 0

uint32_t ref_frames_in_dpb = 0

bool rfi = false

uint32_t width = 0

}	encoder_params
	Current encoder dimensions, pixel format, and reference-frame settings.

std::string	last_nvenc_error_string
	Last NVENC error string.

std::shared_ptr< NV_ENCODE_API_FUNCTION_LIST >	nvenc

NV_ENC_REGISTERED_PTR	registered_input_buffer = nullptr

Detailed Description

Abstract Direct3D11 NVENC encoder. Encapsulates common code used by native and interop implementations.

Constructor & Destructor Documentation

◆ nvenc_d3d11()

nvenc::nvenc_d3d11::nvenc_d3d11	(	NV_ENC_DEVICE_TYPE	device_type,
		::nvenc::shared_dll	dll )

explicit

Initialize an NVENC session wrapper for D3D11 input textures.

Parameters

device_type	NVENC device type used by the encoder session.
dll	Shared NVENC driver module.

Member Function Documentation

◆ get_input_texture()

ID3D11Texture2D * nvenc::nvenc_d3d11::get_input_texture ( )

overridepure virtual

Get input surface texture.

Returns: Input surface texture.

Implements nvenc::nvenc_d3d11_interface.

Implemented in nvenc::nvenc_d3d11_native, and nvenc::nvenc_d3d11_on_cuda.

◆ init_library()

bool nvenc::nvenc_d3d11::init_library ( )

overrideprotectedvirtual

Required. Used for loading NvEnc library and setting nvenc variable with NvEncodeAPICreateInstance(). Called during create_encoder() if nvenc variable is not initialized.

Returns: true on success, false on error

Implements nvenc::nvenc_base.

◆ wait_for_async_event()

bool nvenc::nvenc_d3d11::wait_for_async_event ( uint32_t timeout_ms )

overrideprotectedvirtual

Optional. Override if you want to create encoder in async mode. In this case must also set async_event_handle variable.

Parameters

timeout_ms Wait timeout in milliseconds

Returns: true on success, false on timeout or error

Reimplemented from nvenc::nvenc_base.

The documentation for this class was generated from the following files:

src/nvenc/nvenc_d3d11.h
src/nvenc/nvenc_d3d11.cpp

Public Member Functions

Protected Member Functions