Share via

IPortableDeviceResources::Metode GetStream (portabledeviceapi.h)

  • Artikel

Metode GetStream mendapatkan antarmuka IStream untuk membaca atau menulis data konten dalam objek pada perangkat. Antarmuka yang diambil memungkinkan Anda membaca dari atau menulis ke data objek.

Sintaks

HRESULT GetStream(
  [in]      LPCWSTR        pszObjectID,
  [in]      REFPROPERTYKEY Key,
  [in]      const DWORD    dwMode,
  [in, out] DWORD          *pdwOptimalBufferSize,
  [out]     IStream        **ppStream
);

Parameter

[in] pszObjectID

Penunjuk ke string yang dihentikan null yang berisi ID objek objek.

[in] Key

REFPROPERTYKEY yang menentukan sumber daya mana yang akan dibaca. Anda dapat mengambil kunci semua sumber daya objek dengan memanggil GetSupportedResources.

[in] dwMode

Salah satu mode akses berikut:

  • STGM_READ (Akses baca-saja.)
  • STGM_WRITE (Akses hanya-tulis.)
  • STGM_READWRITE (Akses baca/tulis.)

[in, out] pdwOptimalBufferSize

Penunjuk opsional ke DWORD yang menentukan perkiraan ukuran buffer terbaik untuk digunakan saat membaca atau menulis data dengan menggunakan ppStream. Driver diperlukan untuk mendukung nilai ini.

[out] ppStream

Arahkan ke penunjuk antarmuka IStream . Antarmuka ini digunakan untuk membaca dan menulis data ke objek. Pemanggil harus merilis antarmuka ini ketika selesai dengannya.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_POINTER
 Setidaknya salah satu argumen pointer yang diperlukan adalah NULL.

Keterangan

Aliran yang diambil tidak dapat membaca konten folder secara rekursif. Untuk menyalin semua sumber daya dalam objek, tentukan WPD_RESOURCE_DEFAULT untuk Kunci.

Jika objek tidak mendukung sumber daya, metode ini akan mengembalikan kesalahan, dan ppStream akan null.

Aplikasi harus menggunakan ukuran buffer yang dikembalikan oleh pdwOptimalBufferSize saat mengalokasikan buffer untuk operasi baca atau tulis.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header portabledeviceapi.h
Pustaka PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceResources