IMDSPObject2::WriteOnClearChannel-Methode (mswmdm.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

Aktivieren der Synchronisierung mit Windows Medienwiedergabe

IMDSPObject2-Schnittstelle

IMDSPObject2::ReadOnClearChannel

IMDSPObject::Write