ACMDM_STREAM_PREPARE
.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 preparar os buffers associado com um ACMDRVSTREAMHEADER estrutura.
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
Um valor de retorno de 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 acmStreamPrepareHeader. Suporte para esta mensagem é opcional. No entanto, se um driver suporta esta mensagem, ele deverá suporte ACMDM_STREAM_UNPREPARE.
Se o driver retorna MMSYSERR_NOTSUPPORTED, o ACM prepara os buffers para uso. Para a maioria dos drivers, esse comportamento é suficiente. Se o driver realiza preparação reserva, ela deve retornar MMSYSERR_NOERROR. Em ambos os maiúsculas e minúsculas, o ACM define ACMSTREAMHEADER_STATUSF_PREPARED na fdwStatus memberof ACMDRVSTREAMHEADER. O driver nunca modifica esse sinalizador. Se você desejar o seu driver e o ACM para executar operações de preparação reserva, o driver deve retornar MMSYSERR_NOTSUPPORTED depois de executar sua atividade de preparação. O ACM pode então executar sua operação de preparação.
Antes chamado de driver ACM_IOControl função, o ACM verifica que o seguinte condições foram atendidas:
- ACMDRVSTREAMHEADER é legível e gravável.
- O cbStruct membro de ACMDRVSTREAMHEADER contém um valor tamanho que tenha at least o Mesmo Tamanho como tamanho definido a estrutura.
- Os buffers especificados tiverem não já foi preparados.
Requisitos
| Header | msacmdrv.h |
| Windows Embedded CE | Windows CE 1.0 and later |
See Also
Reference
ACM_Open (ACM Driver)
ACMDRVSTREAMINSTANCE
ACMDRVSTREAMHEADER
ACM_IOControl