ACMDM_STREAM_CONVERT
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Esta mensagem solicita um driver ACM para executar uma operação conversão em transmitir uma conversão especificada.
Parâmetros
- dwDeviceID
Valor que especifica um identificador instância driver. O driver retorna esse valor na resposta para o ACM_Open (Driver ACM) função.
- hDriver
Identificador para um driver.
- uMsg
Valor que especifica esta mensagem.
- lParam1
Ponteiro para um ACMDRVSTREAMINSTANCE estrutura.
- lParam2
Ponteiro para um ACMDRVSTREAMHEADER estrutura.
Valores Return
MMSYSERR_NOERROR indica sucesso. Caso contrário, o driver retorna um dos valores de erro MMSYSERR declarados em um dos valores de erro ACMERR ou o arquivo cabeçalho Mmsystem.h declarado no arquivo de cabeçalho Msacm.h.
Remarks
O ACM (Waveapi.dll) envia esta mensagem por chamado do driver de ACM ACM_IOControl ponto de entrada através de DeviceIoControl função. O ACM envia esta mensagem quando um aplicativo chama o acmStreamConvert função. Todos os drivers ACM que fornecem conversões transmitir devem suporte esta mensagem.
O ACMDRVSTREAMINSTANCE estrutura recebida com essa mensagem é a mesma estrutura recebida com uma mensagem ACMDM_STREAM_OPEN anterior. O driver não é necessário validar conteúdo a estrutura novamente. ACMDRVSTREAMHEADER Identifica os buffers dados de origem e destino. A reserva origem contém os dados a ser convertido. O driver coloca dados convertidos em reserva de destino. O driver deve verificar os sinalizadores in a fdwConvert memberof ACMDRVSTREAMHEADER. Esses sinalizadores indicam como convertidos dados deve ser retornado.
Como as conversões transmitir são tempo-crítico operações, as mensagens ACMDM_STREAM_CONVERT devem ser processadas de forma eficiente. O driver deve executar o máximo de processamento como possíveis na resposta para a mensagem ACMDM_STREAM_OPEN. Se o driver oferecer suporte a assíncrono Operações e o cliente tenha especificado o sinalizador ACM_STREAMOPENF_ASYNC, que está contido na fdwOpen memberof ACMDRVSTREAMINSTANCE, o driver deve levar o seguinte ações quando ele concluiu a conversão de dados na reserva de origem:
- Definir a flagof ACMSTREAMHEADER_STATUSF_DONE ACMDRVSTREAMHEADER.
- Enviar uma mensagem callback MM_ACM_DONE o cliente, chamado de PostThreadMessage função.
Juntamente com o padshNext membro de ACMDRVSTREAMHEADER, assíncrono drivers podem usar o sinalizador ACMSTREAMHEADER_STATUSF_INQUEUE da estrutura para manter uma fila conversão de transmitir cabeçalho estruturas.
Antes chamado de driver ACM_IOControl função, o ACM deve verificar que as seguinte condições foram atendidas:
- A estrutura é legível, gravável e do apropriado tamanho.
- O fdwConvert membro da estrutura contém válido valores sinalizador.
- Buffers da estrutura tiverem sido preparados e tamanhos a reserva especificada não são maior do que seus tamanhos preparados.
- A estrutura não está em um assíncrono conversão fila do driver; Isto é, ACMSTREAMHEADER_STATUSF_INQUEUE sinalizador a estrutura não está definido.
Requisitos
| Header | msacmdrv.h |
| Windows Embedded CE | Windows CE 1.0 and later |
See Also
Reference
ACMDM_STREAM_PREPARE
ACM_Open (ACM Driver)
ACMDRVSTREAMINSTANCE
ACMDRVSTREAMHEADER
ACM_IOControl