Table of Contents

Class D3D11DownloadBlock

Namespace
VisioForge.Core.MediaBlocks.Special
Assembly
VisioForge.Core.dll

Direct3D 11 memory download block for transferring GPU texture data to system memory. This Windows-specific block provides high-performance memory transfer from Direct3D 11 texture resources to CPU-accessible system memory. It handles the complex GPU-to-CPU synchronization, staging texture management, and efficient data copying required for Direct3D 11 interoperability. Features include support for various DXGI formats, automatic format conversion when needed, proper handling of multisampled textures, and optimal memory alignment for CPU access. Essential for screen capture applications, video processing pipelines that need CPU access to GPU-rendered content, computer vision systems processing GPU-accelerated video, and any Windows application requiring efficient readback of Direct3D 11 rendered or decoded video frames. Implements the VisioForge.Core.MediaBlocks.MediaBlock. Implements the VisioForge.Core.MediaBlocks.IMediaBlockInternals. Implements the IDisposable.

public class D3D11DownloadBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

Implements

Inherited Members

Extension Methods

Constructors

D3D11DownloadBlock()

Initializes a new instance of the VisioForge.Core.MediaBlocks.Special.D3D11DownloadBlock class.

public D3D11DownloadBlock()

Properties

Input

Gets the input.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets the inputs.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the output.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets the outputs.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Type

Gets the type.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Constructs and initializes the Direct3D 11 download element and its associated GStreamer components. This method creates the download element, establishes input and output pads, and prepares the block for efficient GPU-to-CPU memory transfers in Direct3D 11 pipelines.

public override bool Build()

Returns

bool

true if the download element was successfully built and configured; false if initialization failed.

CleanUp()

Releases all resources and performs cleanup operations for this Direct3D 11 download block. This method disposes of the GStreamer elements and releases Direct3D 11 resources.

public void CleanUp()

Dispose(bool)

Releases unmanaged and - optionally - managed resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

GetCore()

Gets the core BaseElement wrapper that provides additional functionality around the GStreamer Direct3D 11 download element.

public BaseElement GetCore()

Returns

BaseElement

The BaseElement wrapper instance that encapsulates the GStreamer D3D11 download element.

GetElement()

Gets the underlying GStreamer element that performs Direct3D 11 texture download operations.

public Element GetElement()

Returns

Element

The GStreamer Element instance representing the D3D11 download element.

IsAvailable()

Determines whether this media block is available. Correct NuGet SDK redist should be included into your project.

public static bool IsAvailable()

Returns

bool

true if this media block is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Associates this Direct3D 11 download block with a pipeline and initializes its internal context. This method is called internally when the block is added to a pipeline.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The MediaBlocksPipeline instance that will manage this block.

See Also