使用WPD API通过MTP向安卓传文件：解决ISTREAM.Write的E_FAIL异常

一、WPD API稳定性问题的背景 #

WPD API作为Windows对接MTP设备的官方接口，确实存在历史遗留的稳定性短板：

• 底层通信依赖USB驱动兼容性，部分安卓设备的MTP实现未严格遵循标准，易触发协议层面异常
• API错误处理机制不完善，很多底层通信错误会被封装成模糊的E_FAIL返回，无法定位具体原因
• 高并发或大文件传输场景下，缓冲区管理、设备状态同步逻辑存在漏洞，容易出现偶发失败

二、针对ISTREAM.Write偶发E_FAIL的解决措施 #

1. 严格使用设备推荐的最优缓冲区大小 #

你当前代码手动指定了1024字节缓冲区，但CreateObjectWithPropertiesAndData返回的optimalWriteBufferSize是设备推荐的最优值，强制使用非最优大小可能导致设备端处理异常。修改代码如下：

var buffer = new byte[optimalWriteBufferSize];
// 填充buffer数据
uint bytesWritten = 0;
wpdStream.Write(buffer, buffer.Length, out bytesWritten);
// 校验实际写入字节数，不匹配则执行重试逻辑
if (bytesWritten != buffer.Length)
{
    // 重试逻辑
}

2. 添加针对E_FAIL的有限重试机制 #

由于是偶发异常，针对错误码0x80004005（E_FAIL）添加最多3次左右的重试：

int retryCount = 3;
bool success = false;
while (retryCount > 0 && !success)
{
    try
    {
        wpdStream.Write(buffer, buffer.Length, out uint bytesWritten);
        wpdStream.Commit(0);
        success = true;
    }
    catch (COMException ex) when (ex.ErrorCode == unchecked((int)0x80004005))
    {
        retryCount--;
        // 重试前重置流指针到起始位置
        wpdStream.Seek(0, STREAM_SEEK_SET, IntPtr.Zero);
    }
}

3. 写入前检查设备连接状态 #

避免在设备临时断开（如USB接触不良）时触发异常：

IPortableDeviceValues statusValues = null;
_device.GetDeviceStatus(out statusValues);
uint deviceStatus;
statusValues.GetUnsignedIntegerValue(WPD_DEVICE_STATUS, out deviceStatus);
if (deviceStatus != WPD_DEVICE_STATUS_OK)
{
    // 等待设备恢复或提示用户重新连接
    return;
}

4. 补充必要的属性字段 #

部分安卓设备要求额外属性（如文件类型），否则会拒绝写入，可添加：

values.SetStringValue(WPD_OBJECT_CONTENT_TYPE, "text/plain"); // 根据实际文件类型调整
values.SetUnsignedIntegerValue(WPD_OBJECT_FORMAT, WPD_OBJECT_FORMAT_UNSPECIFIED);

5. 给设备预留初始化时间 #

在创建对象和写入操作之间添加短暂延迟，避免设备未完成初始化就接收数据：

System.Threading.Thread.Sleep(100); // 可根据实际情况调整时长

三、其他注意事项 #

• 上传过程中保持安卓设备解锁，部分设备锁屏时会暂停MTP通信
• 避免传输时切换设备USB模式（如从MTP切换到仅充电）
• 尝试更新Windows USB驱动和设备系统版本，部分兼容性问题在新版本中已修复

内容的提问来源于stack exchange，提问作者user7421317