Método IPortableDeviceResources::GetStream (portabledeviceapi.h)

  • Artículo

El método GetStream obtiene una interfaz IStream con la que leer o escribir los datos de contenido en un objeto de un dispositivo. La interfaz recuperada permite leer o escribir en los datos del objeto.

Sintaxis

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

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que contiene el identificador de objeto del objeto.

[in] Key

REFPROPERTYKEY que especifica qué recurso se va a leer. Puede recuperar las claves de todos los recursos del objeto llamando a GetSupportedResources.

[in] dwMode

Uno de los siguientes modos de acceso:

  • STGM_READ (acceso de solo lectura).
  • STGM_WRITE (acceso de solo escritura).
  • STGM_READWRITE (acceso de lectura y escritura).

[in, out] pdwOptimalBufferSize

Puntero opcional a un DWORD que especifica una estimación del mejor tamaño de búfer que se va a usar al leer o escribir datos mediante ppStream. Se requiere un controlador para admitir este valor.

[out] ppStream

Puntero a un puntero de interfaz IStream . Esta interfaz se usa para leer y escribir datos en el objeto . El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_POINTER
 Al menos uno de los argumentos de puntero necesarios era NULL.

Comentarios

La secuencia recuperada no puede leer el contenido de una carpeta de forma recursiva. Para copiar todos los recursos de un objeto, especifique WPD_RESOURCE_DEFAULT para Key.

Si el objeto no admite recursos, este método devolverá un error y ppStream será NULL.

Las aplicaciones deben usar el tamaño del búfer devuelto por pdwOptimalBufferSize al asignar el búfer para las operaciones de lectura o escritura.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceResources (Interfaz)