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

O método GetStream obtém uma interface IStream com a qual ler ou gravar os dados de conteúdo em um objeto em um dispositivo. A interface recuperada permite que você leia ou escreva nos dados do objeto.

Sintaxe

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

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que contém a ID do objeto.

[in] Key

Uma REFPROPERTYKEY que especifica qual recurso ler. Você pode recuperar as chaves de todos os recursos do objeto chamando GetSupportedResources.

[in] dwMode

Um dos seguintes modos de acesso:

• STGM_READ (acesso somente leitura.)
• STGM_WRITE (acesso somente gravação.)
• STGM_READWRITE (acesso de leitura/gravação.)

[in, out] pdwOptimalBufferSize

Um ponteiro opcional para um DWORD que especifica uma estimativa do melhor tamanho de buffer a ser usado ao ler ou gravar dados usando ppStream. Um driver é necessário para dar suporte a esse valor.

[out] ppStream

Ponteiro para um ponteiro de interface IStream . Essa interface é usada para ler e gravar dados no objeto . O chamador deve liberar essa interface quando terminar de usá-la.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos argumentos de ponteiro necessários era NULL.

Comentários

O fluxo recuperado não pode ler o conteúdo de uma pasta recursivamente. Para copiar todos os recursos em um objeto , especifique WPD_RESOURCE_DEFAULT para Key.

Se o objeto não der suporte a recursos, esse método retornará um erro e ppStream será NULL.

Os aplicativos devem usar o tamanho do buffer retornado por pdwOptimalBufferSize ao alocar o buffer para operações de leitura ou gravação.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceResources Interface