共用方式為

IMbnDeviceService：：WriteData 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

將資料寫入裝置服務資料會話。

語法

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

參數

[in] deviceServiceData

傳入裝置以寫入的位元組陣列。

[out] requestID

行動寬頻服務指派的唯一要求識別碼，用來識別此要求。

傳回值

方法可以傳回下列其中一個值。

傳回碼 描述
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