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

Artículo
03/13/2024

El método Record comienza a grabar desde la entrada de registro externo del dispositivo en la posición de búsqueda actual. Primero se debe llamar al método Seek .

Sintaxis

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Parámetros

[in] pFormat

Puntero a una estructura _WAVEFORMATEX que contiene el formato en el que se deben registrar los datos.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_BUSY	El dispositivo ya está realizando una operación.
WMDM_E_NOTSUPPORTED	La función record no se implementa en este dispositivo.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Este método se usa para invocar la grabación del dispositivo (grabación de una pista de audio que se va a almacenar en el dispositivo multimedia) y transmitir datos de audio desde el dispositivo multimedia que se van a grabar en el equipo. El método Seek determina qué forma de grabación se produce.

Algunos dispositivos no admiten ningún tipo de grabación. Se debe llamar al método GetCapabilities antes de iniciar la grabación. Si se intenta un tipo de grabación no admitido, este método devuelve WMDM_E_NOTSUPPORTED.

Se puede proporcionar un argumento para el parámetro pFormat para especificar un formato de datos de audio para la grabación. Para determinar los formatos admitidos por el dispositivo, consulte IMDSPDevice::GetFormatSupport. Si el parámetro pFormat se establece en NULL, el dispositivo registra los datos de audio en el formato predeterminado.

Al usar la grabación del dispositivo, debe enumerar el contenido del medio de almacenamiento para buscar el nuevo objeto una vez finalizada la operación de registro.