#include "dshow_capture.h"
#include "libavutil/parseutils.h"
#include "libavutil/pixdesc.h"
#include "libavutil/opt.h"
#include "libavutil/mem.h"
#include "libavformat/internal.h"
#include "libavformat/riff.h"
#include "avdevice.h"
#include "libavcodec/raw.h"
#include "objidl.h"
#include "shlwapi.h"
#include "d3d9types.h"
#include "dxva2api.h"

Data Structures
struct	dshow_format_info

Macros
#define	AMCONTROL_COLORINFO_PRESENT 0x00000080

#define	OFFSET(x) offsetof(struct dshow_ctx, x)

#define	DEC AV_OPT_FLAG_DECODING_PARAM

Functions
static enum AVPixelFormat	dshow_pixfmt (DWORD biCompression, WORD biBitCount)

static enum AVColorRange	dshow_color_range (DXVA2_ExtendedFormat *fmt_info)

static enum AVColorSpace	dshow_color_space (DXVA2_ExtendedFormat *fmt_info)

static enum AVColorPrimaries	dshow_color_primaries (DXVA2_ExtendedFormat *fmt_info)

static enum AVColorTransferCharacteristic	dshow_color_trc (DXVA2_ExtendedFormat *fmt_info)

static enum AVChromaLocation	dshow_chroma_loc (DXVA2_ExtendedFormat *fmt_info)

static int	dshow_read_close (AVFormatContext *s)

static char *	dup_wchar_to_utf8 (wchar_t *w)

static int	shall_we_drop (AVFormatContext *s, int index, enum dshowDeviceType devtype)

static void	callback (void priv_data, int index, uint8_t buf, int buf_size, int64_t time, enum dshowDeviceType devtype)

static void	dshow_get_device_media_types (AVFormatContext avctx, enum dshowDeviceType devtype, enum dshowSourceFilterType sourcetype, IBaseFilter device_filter, enum AVMediaType *media_types, int nb_media_types)

static int	dshow_cycle_devices (AVFormatContext avctx, ICreateDevEnum devenum, enum dshowDeviceType devtype, enum dshowSourceFilterType sourcetype, IBaseFilter pfilter, char device_unique_name, AVDeviceInfoList **device_list)
	Cycle through available devices using the device enumerator devenum, retrieve the device with type specified by devtype and return the pointer to the object found in *pfilter. More...

static int	dshow_get_device_list (AVFormatContext avctx, AVDeviceInfoList device_list)

static int	dshow_should_set_format (AVFormatContext *avctx, enum dshowDeviceType devtype)

static struct dshow_format_info *	dshow_get_format_info (AM_MEDIA_TYPE *type)

static void	dshow_get_default_format (IPin pin, IAMStreamConfig config, enum dshowDeviceType devtype, AM_MEDIA_TYPE **type)

static void	dshow_cycle_formats (AVFormatContext avctx, enum dshowDeviceType devtype, IPin pin, int *pformat_set)
	Cycle through available formats available from the specified pin, try to set parameters specified through AVOptions, or the pin's default format if no such parameters were set. More...

static int	dshow_set_audio_buffer_size (AVFormatContext avctx, IPin pin)
	Set audio device buffer size in milliseconds (which can directly impact latency, depending on the device). More...

void	ff_dshow_show_filter_properties (IBaseFilter device_filter, AVFormatContext avctx)
	Pops up a user dialog allowing them to adjust properties for the given filter, if possible. More...

static int	dshow_cycle_pins (AVFormatContext avctx, enum dshowDeviceType devtype, enum dshowSourceFilterType sourcetype, IBaseFilter device_filter, IPin **ppin)
	Cycle through available pins using the device_filter device, of type devtype, retrieve the first output pin and return the pointer to the object found in *ppin. More...

static int	dshow_list_device_options (AVFormatContext avctx, ICreateDevEnum devenum, enum dshowDeviceType devtype, enum dshowSourceFilterType sourcetype)
	List options for device with type devtype, source filter type sourcetype. More...

static int	dshow_open_device (AVFormatContext avctx, ICreateDevEnum devenum, enum dshowDeviceType devtype, enum dshowSourceFilterType sourcetype)

static enum AVCodecID	waveform_codec_id (enum AVSampleFormat sample_fmt)

static enum AVSampleFormat	sample_fmt_bits_per_sample (int bits)

static int	dshow_add_device (AVFormatContext *avctx, enum dshowDeviceType devtype)

static int	parse_device_name (AVFormatContext *avctx)

static int	dshow_read_header (AVFormatContext *avctx)

static int	dshow_check_event_queue (IMediaEvent *media_event)
	Checks media events from DirectShow and returns -1 on error or EOF. More...

static int	dshow_read_packet (AVFormatContext s, AVPacket pkt)

Variables
static const AVOption	options []

static const AVClass	dshow_class

const AVInputFormat	ff_dshow_demuxer

Macro Definition Documentation

◆ AMCONTROL_COLORINFO_PRESENT

#define AMCONTROL_COLORINFO_PRESENT 0x00000080

Definition at line 55 of file dshow.c.

◆ OFFSET

#define OFFSET ( x ) offsetof(struct dshow_ctx, x)

Definition at line 1887 of file dshow.c.

◆ DEC

#define DEC AV_OPT_FLAG_DECODING_PARAM

Definition at line 1888 of file dshow.c.

Function Documentation

◆ dshow_pixfmt()

static enum AVPixelFormat dshow_pixfmt	(	DWORD	biCompression,
		WORD	biBitCount
	)

static

Definition at line 59 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_color_range()

static enum AVColorRange dshow_color_range ( DXVA2_ExtendedFormat * fmt_info )

static

Definition at line 82 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_color_space()

static enum AVColorSpace dshow_color_space ( DXVA2_ExtendedFormat * fmt_info )

static

Definition at line 106 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_color_primaries()

static enum AVColorPrimaries dshow_color_primaries ( DXVA2_ExtendedFormat * fmt_info )

static

Definition at line 130 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_color_trc()

static enum AVColorTransferCharacteristic dshow_color_trc ( DXVA2_ExtendedFormat * fmt_info )

static

Definition at line 167 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_chroma_loc()

static enum AVChromaLocation dshow_chroma_loc ( DXVA2_ExtendedFormat * fmt_info )

static

Definition at line 222 of file dshow.c.

Referenced by dshow_get_format_info().

◆ dshow_read_close()

static int dshow_read_close ( AVFormatContext * s )

static

Definition at line 238 of file dshow.c.

Referenced by dshow_read_header().

◆ dup_wchar_to_utf8()

static char* dup_wchar_to_utf8 ( wchar_t * w )

static

Definition at line 312 of file dshow.c.

Referenced by dshow_cycle_pins().

◆ shall_we_drop()

static int shall_we_drop	(	AVFormatContext *	s,
		int	index,
		enum dshowDeviceType	devtype
	)

static

Definition at line 322 of file dshow.c.

Referenced by callback().

◆ callback()

static void callback	(	void *	priv_data,
		int	index,
		uint8_t *	buf,
		int	buf_size,
		int64_t	time,
		enum dshowDeviceType	devtype
	)

static

Definition at line 341 of file dshow.c.

Referenced by av_log_set_callback(), av_opt_query_ranges(), dshow_open_device(), ff_dshow_filter_Setup(), libspeex_decode_init(), and parse_atoms().

◆ dshow_get_device_media_types()

static void dshow_get_device_media_types	(	AVFormatContext *	avctx,
		enum dshowDeviceType	devtype,
		enum dshowSourceFilterType	sourcetype,
		IBaseFilter *	device_filter,
		enum AVMediaType **	media_types,
		int *	nb_media_types
	)

static

Definition at line 381 of file dshow.c.

◆ dshow_cycle_devices()

static int dshow_cycle_devices	(	AVFormatContext *	avctx,
		ICreateDevEnum *	devenum,
		enum dshowDeviceType	devtype,
		enum dshowSourceFilterType	sourcetype,
		IBaseFilter **	pfilter,
		char **	device_unique_name,
		AVDeviceInfoList **	device_list
	)

static

Cycle through available devices using the device enumerator devenum, retrieve the device with type specified by devtype and return the pointer to the object found in *pfilter.

If pfilter is NULL, list all device names. If device_list is not NULL, populate it with found devices instead of outputting device names to log

Definition at line 462 of file dshow.c.

Referenced by dshow_get_device_list(), dshow_list_device_options(), dshow_open_device(), and dshow_read_header().

◆ dshow_get_device_list()

static int dshow_get_device_list	(	AVFormatContext *	avctx,
		AVDeviceInfoList *	device_list
	)

static

Definition at line 628 of file dshow.c.

◆ dshow_should_set_format()

static int dshow_should_set_format	(	AVFormatContext *	avctx,
		enum dshowDeviceType	devtype
	)

static

Definition at line 660 of file dshow.c.

Referenced by dshow_cycle_formats(), and dshow_cycle_pins().

◆ dshow_get_format_info()

static struct dshow_format_info* dshow_get_format_info ( AM_MEDIA_TYPE * type )

static

Definition at line 692 of file dshow.c.

Referenced by dshow_add_device(), and dshow_cycle_formats().

◆ dshow_get_default_format()

static void dshow_get_default_format	(	IPin *	pin,
		IAMStreamConfig *	config,
		enum dshowDeviceType	devtype,
		AM_MEDIA_TYPE **	type
	)

static

Definition at line 761 of file dshow.c.

Referenced by dshow_cycle_formats().

◆ dshow_cycle_formats()

static void dshow_cycle_formats	(	AVFormatContext *	avctx,
		enum dshowDeviceType	devtype,
		IPin *	pin,
		int *	pformat_set
	)

static

Cycle through available formats available from the specified pin, try to set parameters specified through AVOptions, or the pin's default format if no such parameters were set.

If successful, return 1 in *pformat_set. If pformat_set is NULL, list all pin capabilities.

If we should open the device with the default format, then:

check what the format of the default device is, and
below we iterate all formats till we find a matching one, with most info exposed (see comment below).

Definition at line 794 of file dshow.c.

Referenced by dshow_cycle_pins().

◆ dshow_set_audio_buffer_size()

static int dshow_set_audio_buffer_size	(	AVFormatContext *	avctx,
		IPin *	pin
	)

static

Set audio device buffer size in milliseconds (which can directly impact latency, depending on the device).

Definition at line 1078 of file dshow.c.

Referenced by dshow_cycle_pins().

◆ ff_dshow_show_filter_properties()

void ff_dshow_show_filter_properties	(	IBaseFilter *	device_filter,
		AVFormatContext *	avctx
	)

Pops up a user dialog allowing them to adjust properties for the given filter, if possible.

Definition at line 1122 of file dshow.c.

Referenced by dshow_cycle_pins(), and ff_dshow_try_setup_crossbar_options().

◆ dshow_cycle_pins()

static int dshow_cycle_pins	(	AVFormatContext *	avctx,
		enum dshowDeviceType	devtype,
		enum dshowSourceFilterType	sourcetype,
		IBaseFilter *	device_filter,
		IPin **	ppin
	)

static

Cycle through available pins using the device_filter device, of type devtype, retrieve the first output pin and return the pointer to the object found in *ppin.

If ppin is NULL, cycle through all pins listing audio/video capabilities.

Definition at line 1172 of file dshow.c.

Referenced by dshow_list_device_options(), and dshow_open_device().

◆ dshow_list_device_options()

static int dshow_list_device_options	(	AVFormatContext *	avctx,
		ICreateDevEnum *	devenum,
		enum dshowDeviceType	devtype,
		enum dshowSourceFilterType	sourcetype
	)

static

List options for device with type devtype, source filter type sourcetype.

Parameters

devenum device enumerator used for accessing the device

Definition at line 1299 of file dshow.c.

Referenced by dshow_read_header().

◆ dshow_open_device()

static int dshow_open_device	(	AVFormatContext *	avctx,
		ICreateDevEnum *	devenum,
		enum dshowDeviceType	devtype,
		enum dshowSourceFilterType	sourcetype
	)

static

Definition at line 1317 of file dshow.c.

Referenced by dshow_read_header().

◆ waveform_codec_id()

static enum AVCodecID waveform_codec_id ( enum AVSampleFormat sample_fmt )

static

Definition at line 1506 of file dshow.c.

Referenced by dshow_add_device().

◆ sample_fmt_bits_per_sample()

static enum AVSampleFormat sample_fmt_bits_per_sample ( int bits )

static

Definition at line 1516 of file dshow.c.

Referenced by dshow_add_device().

◆ dshow_add_device()

static int dshow_add_device	(	AVFormatContext *	avctx,
		enum dshowDeviceType	devtype
	)

static

Definition at line 1527 of file dshow.c.

Referenced by dshow_read_header().

◆ parse_device_name()

static int parse_device_name ( AVFormatContext * avctx )

static

Definition at line 1638 of file dshow.c.

Referenced by dshow_read_header().

◆ dshow_read_header()

static int dshow_read_header ( AVFormatContext * avctx )

static

Definition at line 1675 of file dshow.c.

◆ dshow_check_event_queue()

static int dshow_check_event_queue ( IMediaEvent * media_event )

static

Checks media events from DirectShow and returns -1 on error or EOF.

Also purges all events that might be in the event queue to stop the trigger of event notification.

Definition at line 1842 of file dshow.c.

Referenced by dshow_read_packet().

◆ dshow_read_packet()

static int dshow_read_packet	(	AVFormatContext *	s,
		AVPacket *	pkt
	)

static

Definition at line 1857 of file dshow.c.

Variable Documentation

◆ options

const AVOption options[]

static

Initial value:

= {
    { "video_size", "set video size given a string such as 640x480 or hd720.", OFFSET(requested_width), AV_OPT_TYPE_IMAGE_SIZE, {.str = NULL}, 0, 0, DEC },
    { "pixel_format", "set video pixel format", OFFSET(pixel_format), AV_OPT_TYPE_PIXEL_FMT, {.i64 = AV_PIX_FMT_NONE}, -1, INT_MAX, DEC },
    { "framerate", "set video frame rate", OFFSET(framerate), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
    { "sample_rate", "set audio sample rate", OFFSET(sample_rate), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, DEC },
    { "sample_size", "set audio sample size", OFFSET(sample_size), AV_OPT_TYPE_INT, {.i64 = 0}, 0, 16, DEC },
    { "channels", "set number of audio channels, such as 1 or 2", OFFSET(channels), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, DEC },
    { "audio_buffer_size", "set audio device buffer latency size in milliseconds (default is the device's default)", OFFSET(audio_buffer_size), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, DEC },
    { "list_devices", "list available devices",                      OFFSET(list_devices), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, DEC },
    { "list_options", "list available options for specified device", OFFSET(list_options), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, DEC },
    { "video_device_number", "set video device number for devices with same name (starts at 0)", OFFSET(video_device_number), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, DEC },
    { "audio_device_number", "set audio device number for devices with same name (starts at 0)", OFFSET(audio_device_number), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, DEC },
    { "video_pin_name", "select video capture pin by name", OFFSET(video_pin_name),AV_OPT_TYPE_STRING, {.str = NULL},  0, 0, AV_OPT_FLAG_ENCODING_PARAM },
    { "audio_pin_name", "select audio capture pin by name", OFFSET(audio_pin_name),AV_OPT_TYPE_STRING, {.str = NULL},  0, 0, AV_OPT_FLAG_ENCODING_PARAM },
    { "crossbar_video_input_pin_number", "set video input pin number for crossbar device", OFFSET(crossbar_video_input_pin_number), AV_OPT_TYPE_INT, {.i64 = -1}, -1, INT_MAX, DEC },
    { "crossbar_audio_input_pin_number", "set audio input pin number for crossbar device", OFFSET(crossbar_audio_input_pin_number), AV_OPT_TYPE_INT, {.i64 = -1}, -1, INT_MAX, DEC },
    { "show_video_device_dialog",              "display property dialog for video capture device",                            OFFSET(show_video_device_dialog),              AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "show_audio_device_dialog",              "display property dialog for audio capture device",                            OFFSET(show_audio_device_dialog),              AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "show_video_crossbar_connection_dialog", "display property dialog for crossbar connecting pins filter on video device", OFFSET(show_video_crossbar_connection_dialog), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "show_audio_crossbar_connection_dialog", "display property dialog for crossbar connecting pins filter on audio device", OFFSET(show_audio_crossbar_connection_dialog), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "show_analog_tv_tuner_dialog",           "display property dialog for analog tuner filter",                             OFFSET(show_analog_tv_tuner_dialog),           AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "show_analog_tv_tuner_audio_dialog",     "display property dialog for analog tuner audio filter",                       OFFSET(show_analog_tv_tuner_audio_dialog),     AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, DEC },
    { "audio_device_load", "load audio capture filter device (and properties) from file", OFFSET(audio_filter_load_file), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
    { "audio_device_save", "save audio capture filter device (and properties) to file", OFFSET(audio_filter_save_file), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
    { "video_device_load", "load video capture filter device (and properties) from file", OFFSET(video_filter_load_file), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
    { "video_device_save", "save video capture filter device (and properties) to file", OFFSET(video_filter_save_file), AV_OPT_TYPE_STRING, {.str = NULL}, 0, 0, DEC },
    { "use_video_device_timestamps", "use device instead of wallclock timestamps for video frames", OFFSET(use_video_device_timestamps), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, DEC },
    { NULL },
}

Definition at line 1889 of file dshow.c.

◆ dshow_class

const AVClass dshow_class

static

Initial value:

= {
    .class_name = "dshow indev",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
    .category   = AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT,
}

Definition at line 1919 of file dshow.c.

◆ ff_dshow_demuxer

const AVInputFormat ff_dshow_demuxer

Initial value:

= {
    .name           = "dshow",
    .long_name      = NULL_IF_CONFIG_SMALL("DirectShow capture"),
    .priv_data_size = sizeof(struct dshow_ctx),
    .read_header    = dshow_read_header,
    .read_packet    = dshow_read_packet,
    .read_close     = dshow_read_close,
    .get_device_list= dshow_get_device_list,
    .flags          = AVFMT_NOFILE | AVFMT_NOBINSEARCH | AVFMT_NOGENSEARCH | AVFMT_NO_BYTE_SEEK,
    .priv_class     = &dshow_class,
}

Definition at line 1927 of file dshow.c.

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

◆ AMCONTROL_COLORINFO_PRESENT

◆ OFFSET

◆ DEC

Function Documentation

◆ dshow_pixfmt()

◆ dshow_color_range()

◆ dshow_color_space()

◆ dshow_color_primaries()

◆ dshow_color_trc()

◆ dshow_chroma_loc()

◆ dshow_read_close()

◆ dup_wchar_to_utf8()

◆ shall_we_drop()

◆ callback()

◆ dshow_get_device_media_types()

◆ dshow_cycle_devices()

◆ dshow_get_device_list()

◆ dshow_should_set_format()

◆ dshow_get_format_info()

◆ dshow_get_default_format()

◆ dshow_cycle_formats()

◆ dshow_set_audio_buffer_size()

◆ ff_dshow_show_filter_properties()

◆ dshow_cycle_pins()

◆ dshow_list_device_options()

◆ dshow_open_device()

◆ waveform_codec_id()

◆ sample_fmt_bits_per_sample()

◆ dshow_add_device()

◆ parse_device_name()

◆ dshow_read_header()

◆ dshow_check_event_queue()

◆ dshow_read_packet()

Variable Documentation

◆ options

◆ dshow_class

◆ ff_dshow_demuxer