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 |
|---|---|
|
Il metodo è riuscito. |
|
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 |