GetObjectDataOnClearChannel 方法

GetObjectDataOnClearChannel 方法将明文通道上的对象数据块传输回 Windows Media 设备管理器。

此方法与 ISCPSecureExchange::ObjectData 相同,只不过此方法返回的数据未加密。 因此,此方法更高效。

语法

HRESULT GetObjectDataOnClearChannel(
   IMDSPDevice *pDevice,
   BYTE        *pData,
   DWORD       *pdwSize
);

参数

pDevice

指向设备对象的指针。

pData

指向用于接收数据的缓冲区的指针。

pdwSize

指向包含传输大小的 DWORD 的指针。

返回值

如果该方法成功,则它会返回 S_OK。 如果方法失败,则返回 HRESULT 错误代码。

返回代码 说明
WMDM_E_MAC_CHECK_FAILED
消息身份验证代码无效。
WMDM_E_NORIGHTS
调用方没有执行所请求操作所需的权限。
S_FALSE
方法失败。 终止与内容提供程序的交互。
E_INVALIDARG
参数是无效的或 NULL 指针。
E_FAIL
发生了未指定的错误。

备注

若要传输数据,Windows Media 设备管理器调用 TransferContainerDataOnClearChannel 方法来获取容器数据。 然后调用 GetObjectDataOnClearChannel,将对象数据块从内容提供程序传输到 Windows Media 设备管理器。 如果返回S_OK且 pdwSize 设置为零,则 Windows Media 设备管理器 不会请求进一步的数据。

此方法与 ISCPSecureExchange::ObjectData 相同,只不过此方法返回的数据未加密。 因此,此方法更高效。

要求

要求 Value
标头
WMSCP.idl

Mssachlp.lib

另请参阅

ISCPSecureExchange::ObjectData

ISCPSecureExchange3 接口