IMDSPObject2::WriteOnClearChannel-Methode (mswmdm.h)

Artikel
03/04/2024

Die WriteOnClearChannel-Methode schreibt Daten in das Objekt an die aktuelle Position innerhalb des Objekts, ohne sichere authentifizierte Kanäle zu verwenden. 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::Write durch, wenn bei dieser Methode ein Fehler auftritt.

Syntax

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

Parameter

[in] pData

Zeiger auf den Puffer, der die Daten enthält, die in das Objekt geschrieben werden sollen.

[in, out] pdwSize

Zeiger auf ein DWORD , das die Anzahl der zu schreibenden Daten in Bytes enthält. Nach der Rückgabe enthält dieser Parameter die tatsächliche Anzahl der geschriebenen Bytes.

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 mit DRM-geschützten Inhalten verwendet werden. Es ist effizienter als IMDSPObject::Write , da diese Methode keine Ver- und Entschlüsselung von Parametern beinhaltet.

Im Gegensatz zu IMDSPObject::Write muss diese Methode die Daten vor dem Schreiben auf ein Gerät nicht entschlüsseln und ist daher effizienter.