MÉTHODE IMDSPObject2 ::WriteOnClearChannel (mswmdm.h)

Article
02/29/2024

La méthode WriteOnClearChannel écrit des données dans l’objet à la position actuelle dans l’objet, sans utiliser de canaux authentifiés sécurisés. Cette opération n’est valide que si l’objet de stockage représente un fichier. Si IMDSPObject2 est pris en charge, cette méthode doit être implémentée. Windows Media Gestionnaire de périphériques ne revient pas à IMDSPObject ::Write si cette méthode échoue.

Syntaxe

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

Paramètres

[in] pData

Pointeur vers la mémoire tampon contenant les données à écrire dans l’objet.

[in, out] pdwSize

Pointeur vers un DWORD contenant le nombre d’octets de données à écrire. Lors du retour, ce paramètre contient le nombre réel d’octets écrits.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Cette méthode peut être utilisée avec du contenu protégé par DRM. Elle est plus efficace que IMDSPObject ::Write , car cette méthode n’implique pas le chiffrement et le déchiffrement des paramètres.

Contrairement à IMDSPObject ::Write, cette méthode n’a pas besoin de déchiffrer les données avant d’écrire sur un appareil et est donc plus efficace.