Metodo IMDSPObject2::WriteOnClearChannel (mswmdm.h)

Articolo
03/05/2024

Il metodo WriteOnClearChannel scrive i dati nell'oggetto nella posizione corrente all'interno dell'oggetto, senza utilizzare canali autenticati sicuri. Questa operazione è valida solo se l'oggetto di archiviazione rappresenta un file. Se IMDSPObject2 è supportato, questo metodo deve essere implementato. Windows Media Gestione dispositivi non esegue il fallback a IMDSPObject::Write se questo metodo non riesce.

Sintassi

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

Parametri

[in] pData

Puntatore al buffer contenente i dati da scrivere nell'oggetto .

[in, out] pdwSize

Puntatore a un DWORD contenente il numero di byte di dati da scrivere. Al termine della restituzione, questo parametro contiene il numero effettivo di byte scritti.

Valore restituito

Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Questo metodo può essere usato con contenuto protetto da DRM. È più efficiente di IMDSPObject::Write perché questo metodo non comporta la crittografia e la decrittografia dei parametri.

A differenza di IMDSPObject::Write, questo metodo non deve decrittografare i dati prima di scrivere in un dispositivo ed è quindi più efficiente.