IMDSPObject2::WriteOnClearChannel 方法 (mswmdm.h)

WriteOnClearChannel 方法将数据写入对象中的当前位置,而无需使用经过安全身份验证的通道。 仅当存储对象表示文件时,此操作才有效。 如果支持 IMDSPObject2 ,则必须实现此方法。 如果此方法失败,Windows Media 设备管理器 不会回退到 IMDSPObject::Write

语法

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

参数

[in] pData

指向包含要写入对象的数据的缓冲区的指针。

[in, out] pdwSize

指向包含要写入的数据字节数的 DWORD 的指针。 返回时,此参数包含实际写入的字节数。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

此方法可用于受 DRM 保护的内容。 它比 IMDSPObject::Write 更有效,因为此方法不涉及加密和解密参数。

IMDSPObject::Write 不同,此方法在写入设备之前不需要解密数据,因此效率更高。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

启用与Windows 媒体播放器同步

IMDSPObject2 接口

IMDSPObject2::ReadOnClearChannel

IMDSPObject::Write