通过

IMbnDeviceService：：WriteData 方法 (mbnapi.h)

  • 项目

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的 Windows 运行时 API。

将数据写入设备服务数据会话。

语法

HRESULT WriteData(
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

parameters

[in] deviceServiceData

传入设备以写入的字节数组。

[out] requestID

由移动宽带服务分配的唯一请求 ID，用于标识此请求。

返回值

方法可以返回以下值之一。

返回代码 说明
S_OK
 该方法已成功完成。
E_ACCESSDENIED
 不允许使用此设备服务命令调用进程特权。
HRESULT_FROM_WIN32 (ERROR_BUFFER_OVERFLOW)
deviceServiceData 的长度大于支持的 MaxDataSize。
HRESULT_FROM_WIN32 (ERROR_OPEN_FAILED)
设备服务会话未打开。
其他
 执行此方法时遇到错误。

注解

WriteData 将批量数据传递给设备上的特定于供应商的设备服务。 移动宽带服务会将此请求转发到设备。 deviceServiceData 将逐字节复制到传入请求的数据缓冲区中。 此数据缓冲区必须小于 MaxDataSize 字节。

必须先打开数据会话，应用程序才能调用 WriteData。 操作系统不保证 WriteData 的延迟或性能。

这是一个异步操作， WriteData 将立即返回。 操作完成后，移动宽带服务将调用 IMbnDeviceServicesEvents 接口的 OnWriteDataComplete 方法。

要求

   
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnDeviceService