summaryrefslogtreecommitdiff
path: root/general/SimpleMediaSource/README.md
blob: 4467f16b2d2adc2f41f36475a3d9eafbdd23df6f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
---
page_type: sample
description: "Demonstrates how to write a custom media source and driver package."
languages:
- cpp
products:
- windows
- windows-wdk
---

# SimpleMediaSource sample

This sample demonstrates how to create a custom media source and driver package that can be installed as a camera and produce frames.

For more information, see the accompanying documentation at [Frame Server Custom Media Source](https://docs.microsoft.com/windows-hardware/drivers/stream/frame-server-custom-media-source).

## Contents

- MediaSource - COM DLL project for the custom media source
- SimpleMediaSourceDriver - UMDF driver install package

## Installation

1. Build the solution.

1. Navigate to the output folder, e.g. Windows-driver-samples\general\SimpleMediaSource\x64\Release, and the driver package will be in a directory also called SimpleMediaSourceDriver. Check that the folder has `SimpleMediaSource.dll`, `simplemediasourcedriver.cat`, `SimpleMediaSourceDriver.dll`, and `SimpleMediaSourceDriver.inf`.

1. Deploy the driver package with the following command:

    `devcon dp_add SimpleMediaSourceDriver.inf`

1. In Device Manager, locate **SimpleMediaSource Capture Source**, under the Camera category. Open the Microsoft Camera App, switch cameras if necessary until the camera is streaming from the SimpleMediaSource. You should see a scrolling black and white gradient.