Método IMDSPObject2::WriteOnClearChannel (mswmdm.h)

Artigo
02/29/2024

O método WriteOnClearChannel grava dados no objeto na posição atual dentro do objeto, sem usar canais autenticados seguros. Essa operação só será válida se o objeto de armazenamento representar um arquivo. Se houver suporte para IMDSPObject2 , esse método deverá ser implementado. O Windows Media Gerenciador de Dispositivos não retornará ao IMDSPObject::Write se esse método falhar.

Sintaxe

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

Parâmetros

[in] pData

Ponteiro para o buffer que contém os dados a serem gravados no objeto .

[in, out] pdwSize

Ponteiro para um DWORD que contém o número de bytes de dados a serem gravados. Após o retorno, esse parâmetro contém o número real de bytes gravados.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

Códigos de erro COM padrão
Códigos de erro do Windows convertidos em valores HRESULT
Códigos de erro do Windows Media Gerenciador de Dispositivos

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método pode ser usado com conteúdo protegido por DRM. Ele é mais eficiente do que IMDSPObject::Write porque esse método não envolve criptografar e descriptografar parâmetros.

Ao contrário de IMDSPObject::Write, esse método não precisa descriptografar os dados antes de gravar em um dispositivo e, portanto, é mais eficiente.