简介

PortableDeviceApi，简称PDA，是一个Windows应用程序编程接口（API），允许用户通过应用程序访问和管理连接到计算机的便携式设备。这些设备可包括数字相机、手机、MP3播放器等。

当我们连接数字相机或MP3播放器等设备到电脑时，我们通常会使用熟悉的文件管理器，如Windows资源管理器或Finder（苹果电脑），来浏览、复制或删除设备上的文件。然而，随着设备和电脑的不断更新，很多用户面临着以下情况：

1. 充电和存储模式切换问题

2. 难于识别和浏览设备上的文件

3. 传输速度缓慢

4. 不能进行批量操作

这些问题都可以通过使用PortableDeviceApi解决。PortbableDeviceApi不仅提供了一个更高效和友好的界面来管理设备，还可以与其他应用程序和工具一起使用，如音乐管理器、图片编辑器等。

PortableDeviceApi由微软发布的Windows SDK中包含，并提供了不同的编程语言支持，如C++、C#、VB.NET等。在本文中，我们将关注使用C#编写PortableDeviceApi应用程序。

准备工作

在使用PortableDeviceApi之前，您需要完成以下准备工作：

1. 安装Windows SDK。可以通过微软官方网站下载并安装最新版本的SDK。在安装过程中，您需要选择“Windows Portable Devices”组件以确保安装了PortableDeviceApi。

2. 安装Visual Studio。PortableDeviceApi是一个.NET框架类库，因此您需要使用.NET开发工具，如Visual Studio 2017或更高版本。

使用PortableDeviceApi

下面是一个基本的PortableDeviceApi应用程序示例，演示如何枚举和获取连接到计算机的设备列表。

首先，我们需要导入PortableDeviceApi和PortableDeviceTypes命名空间：

```

using PortableDeviceApiLib; // PortableDeviceApi命名空间

using PortableDeviceTypesLib; // PortableDeviceTypes命名空间

```

我们还需要定义PortableDeviceManager和PortableDevice对象：

```

PortableDeviceManagerClass deviceManager = new PortableDeviceManagerClass();

PortableDeviceClass device = new PortableDeviceClass();

```

PortableDeviceManager是PortableDeviceApi的主要对象之一，它提供了管理连接到计算机的便携式设备的方法。PortableDevice是指代连接设备的特定实例，您可以使用PortableDevice对象执行对设备的特定操作。

接下来，我们可以使用PortableDeviceManager对象的GetDevices方法获取连接到计算机的所有设备的ID：

```

deviceManager.GetDevices(ref deviceIds);

```

此方法是一个输出参数，它将所有设备的ID存储在数组deviceIds中。

现在，我们可以循环遍历所有设备，找到我们需要的设备。以下是判断特定设备是否连接到计算机的代码：

```

foreach (string deviceId in deviceIds)

{

device.Open(deviceId, clientName);

string deviceName = GetDeviceFriendlyName(device); // 获取设备友好名称

if (deviceName.Equals("My Camera"))

{

// 我们找到了特定设备，可以执行相关操作了

// …

}

device.Close();

}

```

在上面的代码中，我们打开每个设备，并获取它的友好名称，该名称将告诉我们它是什么设备。如果我们找到了我们需要的设备（在此示例中为“My Camera”），我们可以执行相关操作。

您可以使用以下方法之一与设备进行交互：

1. 使用PortableDevice对象的Browse方法浏览驱动器（设备）内容：

```

IPortableDeviceContent content;

device.Content(out content);

PortableDeviceApiLib.IPortableDeviceProperties properties;

content.Properties(out properties);

var folderId = new _tagpropertykey();

folderId.fmtid = new Guid(0x0EF50AF5, 0x2EFD, 0x4867, 0xB8, 0x6F, 0x26, 0x0, 0x69, 0xB9, 0xF8, 0x4);

folderId.pid = 2;

IPortableDeviceProperties hardDiskProperties;

IPortableDeviceValues hardDiskValues;

properties.GetValues(

"DEVICE", null, out hardDiskProperties);

hardDiskProperties.GetValues(

folderId, null, out hardDiskValues);

PortableDeviceApiLib.IEnumPortableDeviceObjectIDs objectIds;

content.EnumObjects(

0,

PortableDeviceApiLib.DEVICE_TRANSPORT.EnumFlag(0),

null,

out objectIds);

uint fetched = 0;

do

{

string objectId;

objectIds.Next(1, out objectId, ref fetched);

if (fetched > 0)

{

PortableDeviceApiLib.IPortableDeviceProperties propertiesObject;

content.Properties(out propertiesObject);

IPortableDeviceValues objectValues;

propertiesObject.GetValues(objectId, null, out objectValues);

// …

}

} while (fetched > 0);

```

2. 使用PortableDevice对象的CopyContentToDevice方法将文件复制到设备中：

```

IPortableDeviceContent content;

device.Content(out content);

IPortableDeviceValues values = GetRequiredPropertiesForContentType(fileName, parentObjectId, false);

uint optimalTransferSize = 0;

content.GetOptimalTransferSize(

PortableDeviceApiLib.WPD_OBJECT_FORMAT.WPD_OBJECT_FORMAT_WMA, parentObjectId, values, out optimalTransferSize);

var queue = new PortableDeviceApiLib.PortableDevicePropVariantCollection();

queue.Add(new PortableDeviceApiLib.PropVariant() { vt = 0x1F, wReserved1 = 0, wReserved2 = 0, wReserved3 = 0, bstrVal = fileName });

content.CopyContentToDevice(

queue, parentObjectId, values, null, out transferResult);

```

在上面的代码中，我们使用GetRequiredPropertiesForContentType方法获取要复制到设备的文件的属性。此方法返回一个IPortableDeviceValues对象，该对象包含文件名、大小和格式等信息。我们还使用GetOptimalTransferSize方法获取最佳传输大小，然后使用CopyContentToDevice方法将文件添加到设备中。

总结

使用PortableDeviceApi可以轻松地管理连接到计算机的便携式设备。在本文中，我们讨论了如何使用C#编写PortableDeviceApi应用程序。我们学习了如何获取连接到计算机的所有设备，遍历它们并找到所需设备，浏览设备的内容以及将文件复制到设备中。PortbableDeviceApi提供了一个高效和友好的界面，让用户更轻松地管理他们的便携式设备。