# 桌面端视频设备管理 (/zh-CN/api-reference/rtc/csharp-windows/device-management/pc-video-device-management)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## EnumerateVideoDevices [#enumeratevideodevices]
获取系统中所有的视频设备列表。
```csharp
public abstract DeviceInfo[] EnumerateVideoDevices();
```
### 详情 [#详情]
### 返回值 [#返回值]
- 方法调用成功:返回一个 [DeviceInfo](/zh-CN/api-reference/rtc/csharp-windows/class-videodeviceinfo) 数组,其中包含系统中所有视频设备。
- 方法调用失败: 返回空列表。
## GetCapability [#getcapability]
获取视频采集设备在指定的视频格式下的详细视频帧信息。
```csharp
public abstract int GetCapability(string deviceIdUTF8, uint deviceCapabilityNumber, out VideoFormat capability);
```
### 详情 [#详情-1]
在调用 [NumberOfCapabilities](/zh-CN/api-reference/rtc/csharp-windows/device-management/pc-video-device-management#api_ivideodevicemanager_numberofcapabilities) 获取视频采集设备支持的视频格式数量后,你可以调用该方法获取指定索引号支持的具体视频帧信息。
### 参数 [#参数]
视频采集设备的 ID。
视频格式的索引号。如果 NumberOfCapabilities 的返回值为 i,则该参数取值范围为[0,i)。
输出参数。表示指定视频格式的具体信息,包括宽度(px),高度(px)和帧率(fps)。详见 [VideoFormat](/zh-CN/api-reference/rtc/csharp-windows/class-videoformat)。
### 返回值 [#返回值-1]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## GetVideoDeviceManager [#getvideodevicemanager]
获取 [IVideoDeviceManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_ivideodevicemanager) 对象,以管理视频设备。
```csharp
public abstract IVideoDeviceManager GetVideoDeviceManager();
```
### 返回值 [#返回值-2]
一个 [IVideoDeviceManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_ivideodevicemanager) 对象。
## GetDevice [#getdevice]
获取当前使用的视频采集设备。
```csharp
public abstract int GetDevice(ref string deviceIdUTF8);
```
### 详情 [#详情-2]
### 参数 [#参数-1]
输出参数。设备 ID。
### 返回值 [#返回值-3]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## OnVideoDeviceStateChanged [#onvideodevicestatechanged]
视频设备变化回调。
```csharp
public virtual void OnVideoDeviceStateChanged(string deviceId, int deviceType, int deviceState)
```
### 详情 [#详情-3]
该回调提示系统视频设备状态发生改变,比如被拔出或移除。如果设备已使用外接摄像头采集,外接摄像头被拔开后,视频会中断。
### 参数 [#参数-2]
设备 ID。
设备类型。详见 [MEDIA_DEVICE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-mediadevicetype)。
设备状态。详见 [MEDIA_DEVICE_STATE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-mediadevicestatetype) 。
## NumberOfCapabilities [#numberofcapabilities]
获取指定视频采集设备支持的视频格式数量。
```csharp
public abstract int NumberOfCapabilities(string deviceIdUTF8);
```
### 详情 [#详情-4]
视频采集设备可能支持多种视频格式,每一种格式都支持不同的视频帧宽度、视频帧高度、帧率组合。
你可以通过调用该方法,获取指定的视频采集设备可支持多少种视频格式,然后调用 [GetCapability](/zh-CN/api-reference/rtc/csharp-windows/device-management/pc-video-device-management#api_ivideodevicemanager_getcapability) 获取指定视频格式下的具体视频帧信息。
### 参数 [#参数-3]
视频采集设备的 ID。
### 返回值 [#返回值-4]
- > 0: 方法调用成功。返回该设备支持的视频格式数量。例如:如果指定的摄像头支持 10 种不同的视频格式,则返回值为 10。
- ≤ 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## QueryCodecCapability [#querycodeccapability]
查询 SDK 支持的视频编解码能力。
```csharp
public abstract int QueryCodecCapability(ref CodecCapInfo[] codecInfo, ref int size);
```
### 详情 [#详情-5]
### 参数 [#参数-4]
输入和输出参数,表示 SDK 的视频编码能力数组。详见 [CodecCapInfo](/zh-CN/api-reference/rtc/csharp-windows/class-codeccapinfo)。
- 输入值:用户执行该方法时定义的 CodecCapInfo,表示待查询的视频编解码能力。
- 输出值:方法执行完毕后输出的 CodecCapInfo,表示 SDK 实际支持的视频编解码能力。
输入和输出参数,表示 CodecCapInfo 数组的大小。
- 输入值:用户执行该方法时定义的 CodecCapInfo 的大小。
- 输出值:方法执行完毕后输出的 CodecCapInfo 的大小。
### 返回值 [#返回值-5]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine)