IMDSPObject2::ReadOnClearChannel-Methode (mswmdm.h)

Artikel
03/04/2024

Die ReadOnClearChannel-Methode liest Daten aus dem Objekt an der aktuellen Position, ohne sichere authentifizierte Kanäle zu verwenden. Dies ist weiterhin sicher für die Verwendung mit DRM-geschützten Inhalten. Dieser Vorgang ist nur gültig, wenn das Speicherobjekt eine Datei darstellt. Wenn IMDSPObject2 unterstützt wird, muss diese Methode implementiert werden. Windows Media Geräte-Manager führt keinen Fallback auf IMDSPObject::Read durch, wenn diese Methode fehlschlägt.

Syntax

HRESULT ReadOnClearChannel(
  [out]     BYTE  *pData,
  [in, out] DWORD *pdwSize
);

Parameter

[out] pData

Zeiger auf einen Puffer, um die aus dem Objekt gelesenen Daten zu empfangen.

[in, out] pdwSize

Zeiger auf ein DWORD , das die Anzahl der zu lesenden Daten in Bytes angibt. Bei der Rückgabe enthält dieser Parameter die tatsächliche Menge der gelesenen Daten.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode kann für DRM-geschützte Inhalte verwendet werden. Diese Methode ist effizienter als IMDSPObject::Read , da diese Methode keine Ver- und Entschlüsselung von Parametern beinhaltet.