IPortableDeviceResources::Metode GetStream (portabledeviceapi.h)
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 |
---|---|
|
Metode berhasil. |
|
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 |