Método IAudioProcessingObjectConfiguration::LockForProcess (audioenginebaseapo.h)

  • Artigo

O LockForProcess método é usado para verificar se o APO está bloqueado e pronto para processar dados.

Sintaxe

HRESULT LockForProcess(
  [in] UINT32                    u32NumInputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
  [in] UINT32                    u32NumOutputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);

Parâmetros

[in] u32NumInputConnections

Número de conexões de entrada anexadas a esse APO.

[in] ppInputConnections

Descritor de conexão para cada conexão de entrada anexada a esse APO.

[in] u32NumOutputConnections

Número de conexões de saída anexadas a esse APO.

[in] ppOutputConnections

Descritor de conexão para cada conexão de saída anexada a esse APO.

Retornar valor

O LockForProcess método retornará um valor de S_OK se a chamada for concluída com êxito. Nesta fase, o APO está bloqueado e está pronto para processar dados.

Código de retorno Descrição
E_POINTER
 O ponteiro inválido foi passado para a função.
APOERR_INVALID_CONNECITON_FORMAT
 Formato de conexão inválido.
APOERR_NUM_CONNECTIONS_INVALID
 Número de conexões de entrada ou saída não válidas neste APO.
APOERR_APO_LOCKED
 O APO já está bloqueado.
Outros HRESULTS
 Essas falhas serão controladas pelo mecanismo de áudio.

Comentários

Quando o LockForProcess método é chamado, ele primeiro executa uma marcar interna para ver se o APO foi inicializado e está pronto para processar dados. Cada APO tem requisitos de inicialização diferentes, portanto, cada APO deve definir seu próprio método Initialize, se necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível com o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho audioenginebaseapo.h
Biblioteca Audioenginebaseapo.idl
IRQL Todos os níveis