IPortableDeviceResources::GetStream-Methode (portabledeviceapi.h)
Die GetStream-Methode ruft eine IStream-Schnittstelle ab, mit der die Inhaltsdaten in einem Objekt auf einem Gerät gelesen oder geschrieben werden sollen. Mit der abgerufenen Schnittstelle können Sie aus den Objektdaten lesen oder in diese schreiben.
Syntax
HRESULT GetStream(
[in] LPCWSTR pszObjectID,
[in] REFPROPERTYKEY Key,
[in] const DWORD dwMode,
[in, out] DWORD *pdwOptimalBufferSize,
[out] IStream **ppStream
);
Parameter
[in] pszObjectID
Zeiger auf eine NULL-beendete Zeichenfolge, die die Objekt-ID des Objekts enthält.
[in] Key
Ein REFPROPERTYKEY , der angibt, welche Ressource gelesen werden soll. Sie können die Schlüssel aller Ressourcen des Objekts abrufen, indem Sie GetSupportedResources aufrufen.
[in] dwMode
Einer der folgenden Zugriffsmodi:
- STGM_READ (schreibgeschützter Zugriff.)
- STGM_WRITE (schreibgeschützter Zugriff.)
- STGM_READWRITE (Lese-/Schreibzugriff.)
[in, out] pdwOptimalBufferSize
Ein optionaler Zeiger auf ein DWORD , der eine Schätzung der besten Puffergröße angibt, die beim Lesen oder Schreiben von Daten mithilfe von ppStream verwendet werden kann. Zur Unterstützung dieses Werts ist ein Treiber erforderlich.
[out] ppStream
Zeiger auf einen IStream-Schnittstellenzeiger . Diese Schnittstelle wird verwendet, um Daten zu lesen und in das -Objekt zu schreiben. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie damit fertig ist.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens eines der erforderlichen Zeigerargumente war NULL. |
Hinweise
Der abgerufene Stream kann den Inhalt eines Ordners nicht rekursiv lesen. Um alle Ressourcen in einem -Objekt zu kopieren, geben Sie WPD_RESOURCE_DEFAULT für Key an.
Wenn das Objekt keine Ressourcen unterstützt, gibt diese Methode einen Fehler zurück, und ppStream ist NULL.
Anwendungen sollten die von pdwOptimalBufferSize zurückgegebene Puffergröße verwenden, wenn sie den Puffer für Lese- oder Schreibvorgänge zuweisen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |