Поделиться через

Метод IPortableDeviceResources::GetStream (portabledeviceapi.h)

  • Статья

Метод GetStream получает интерфейс IStream для чтения или записи данных содержимого в объекте на устройстве. Полученный интерфейс позволяет считывать данные объекта или записывать их в нее.

Синтаксис

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

Параметры

[in] pszObjectID

Указатель на строку, завершающуюся нулевым значением, которая содержит идентификатор объекта .

[in] Key

REFPROPERTYKEY, указывающий, какой ресурс следует считать. Ключи всех ресурсов объекта можно получить, вызвав Метод GetSupportedResources.

[in] dwMode

Один из следующих режимов доступа:

  • STGM_READ (доступ только для чтения).
  • STGM_WRITE (доступ только для записи).
  • STGM_READWRITE (доступ для чтения и записи).

[in, out] pdwOptimalBufferSize

Необязательный указатель на DWORD , указывающий оптимальный размер буфера для чтения или записи данных с помощью ppStream. Для поддержки этого значения требуется драйвер.

[out] ppStream

Указатель на указатель интерфейса IStream . Этот интерфейс используется для чтения и записи данных в объект . Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 По крайней мере один из обязательных аргументов указателя имел значение NULL.

Комментарии

Полученный поток не может рекурсивно считывать содержимое папки. Чтобы скопировать все ресурсы в объекте , укажите WPD_RESOURCE_DEFAULT в поле Ключ.

Если объект не поддерживает ресурсы, этот метод возвращает ошибку, а ppStream будет иметь значение NULL.

Приложения должны использовать размер буфера, возвращаемый pdwOptimalBufferSize при выделении буфера для операций чтения или записи.

Требования

Требование Значение
Целевая платформа Windows
Header portabledeviceapi.h
Библиотека PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceResources