Método IMDSPDeviceControl::Record (mswmdm.h)

Artigo
03/15/2023

O método Record inicia a gravação da entrada de registro externo do dispositivo na posição de busca atual. O método Seek deve ser chamado primeiro.

Sintaxe

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Parâmetros

[in] pFormat

Ponteiro para uma estrutura _WAVEFORMATEX que contém o formato no qual os dados devem ser registrados.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_BUSY	O dispositivo já está executando uma operação.
WMDM_E_NOTSUPPORTED	A função de registro não é implementada neste dispositivo.
E_FAIL	Ocorreu um erro não especificado.

Comentários

Esse método é usado para invocar a gravação do dispositivo (gravação de uma faixa de áudio a ser armazenada no dispositivo de mídia) e transmitir dados de áudio do dispositivo de mídia a serem gravados no computador. O método Seek determina qual forma de gravação ocorre.

Alguns dispositivos não dão suporte a nenhum tipo de gravação. O método GetCapabilities deve ser chamado antes de iniciar a gravação. Se um tipo de gravação sem suporte for tentado, esse método retornará WMDM_E_NOTSUPPORTED.

Um argumento para o parâmetro pFormat pode ser fornecido para especificar um formato de dados de áudio para gravação. Para determinar os formatos compatíveis com o dispositivo, consulte IMDSPDevice::GetFormatSupport. Se o parâmetro pFormat for definido como NULL, o dispositivo registrará dados de áudio no formato padrão.

Ao usar a gravação do dispositivo, você deve enumerar o conteúdo médio de armazenamento para localizar o novo objeto após a conclusão da operação de registro.