Metodo IPortableDeviceResources::GetStream (portabledeviceapi.h)

Il metodo GetStream ottiene un'interfaccia IStream con cui leggere o scrivere i dati del contenuto in un oggetto in un dispositivo. L'interfaccia recuperata consente di leggere o scrivere nei dati dell'oggetto.

Sintassi

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

Parametri

[in] pszObjectID

Puntatore a una stringa con terminazione null contenente l'ID oggetto dell'oggetto.

[in] Key

REFPROPERTYKEY che specifica quale risorsa leggere. È possibile recuperare le chiavi di tutte le risorse dell'oggetto chiamando GetSupportedResources.

[in] dwMode

Una delle modalità di accesso seguenti:

• STGM_READ (accesso di sola lettura).
• STGM_WRITE (accesso solo scrittura).
• STGM_READWRITE (accesso in lettura/scrittura).

[in, out] pdwOptimalBufferSize

Puntatore facoltativo a un DWORD che specifica una stima delle dimensioni del buffer migliori da usare durante la lettura o la scrittura di dati usando ppStream. Per supportare questo valore è necessario un driver.

[out] ppStream

Puntatore a un puntatore dell'interfaccia IStream . Questa interfaccia viene usata per leggere e scrivere dati nell'oggetto. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Almeno uno degli argomenti del puntatore richiesto è NULL.

Commenti

Il flusso recuperato non può leggere il contenuto di una cartella ricorsivamente. Per copiare tutte le risorse in un oggetto, specificare WPD_RESOURCE_DEFAULT per Key.

Se l'oggetto non supporta le risorse, questo metodo restituirà un errore e ppStream sarà NULL.

Le applicazioni devono usare le dimensioni del buffer restituite da pdwOptimalBufferSize durante l'allocazione del buffer per operazioni di lettura o scrittura.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDeviceResources