Bagikan melalui

Metode IMbnDeviceService::WriteData (mbnapi.h)

  • Artikel

Penting

Mulai dari Windows 10, versi 1803, API Win32 yang dijelaskan di bagian ini digantikan oleh WINDOWS Runtime API di namespace Windows.Networking.Connectivity.

Menulis data ke sesi data layanan perangkat.

Sintaks

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

Parameter

[in] deviceServiceData

Array byte yang diteruskan ke perangkat untuk menulis.

[out] requestID

ID permintaan unik yang ditetapkan oleh layanan Mobile Broadband untuk mengidentifikasi permintaan ini.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_ACCESSDENIED
 Perintah layanan perangkat ini tidak diperbolehkan untuk memanggil hak istimewa proses.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
 Panjang deviceServiceData lebih besar dari MaxDataSize yang didukung.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)
 Sesi layanan perangkat tidak terbuka.
Lainnya
 Terjadi kesalahan saat menjalankan metode ini.

Keterangan

WriteData meneruskan data massal ke layanan perangkat khusus vendor di perangkat. Layanan Broadband Seluler akan meneruskan permintaan ini ke perangkat. deviceServiceData akan disalin byte-byte ke dalam buffer data yang diteruskan ke permintaan. Buffer data ini harus kurang dari byte MaxDataSize .

Sesi data harus dibuka sebelum aplikasi dapat memanggil WriteData. Sistem operasi tidak memberikan jaminan pada latensi atau performa WriteData.

Ini adalah operasi asinkron dan WriteData akan segera kembali. Setelah menyelesaikan operasi, layanan Mobile Broadband akan memanggil metode OnWriteDataComplete dari antarmuka IMbnDeviceServicesEvents .

Persyaratan

   
Target Platform Windows
Header mbnapi.h

Lihat juga

IMbnDeviceService