Método IXAPO::LockForProcess (xapo.h)

Chamado por XAudio2 para bloquear as configurações de entrada e saída de um XAPO, permitindo que ele faça qualquer inicialização final antes que Process seja chamado no thread em tempo real.

Sintaxe

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

Parâmetros

InputLockedParameterCount

Número de elementos em ppInputLockedParameters. Deve estar dentro do XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount e XAPO_REGISTRATION_PROPERTIES. Valores MaxInputBufferCount passados para CXAPOBase::CXAPOBase.

pInputLockedParameters

Matriz de estruturas de XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS de entrada. pInputLockedParameters poderá ser NULL se InputLockedParameterCount for 0, caso contrário, ele deverá ter elementos InputLockedParameterCount .

OutputLockedParameterCount

Número de elementos em ppOutputLockedParameters. Deve estar dentro do XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount e XAPO_REGISTRATION_PROPERTIES. Valores MaxOutputBufferCount passados para CXAPOBase::CXAPOBase. Se o sinalizador XAPO_FLAG_BUFFERCOUNT_MUST_MATCH tiver sido especificado em XAPO_REGISTRATION_PROPERTIES. Sinalizadores, em seguida , OutputLockedParameterCount deve ser igual a InputLockedParameterCount.

pOutputLockedParameters

Matriz de estruturas de XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS de saída. pOutputLockedParameters poderá ser NULL se OutputLockedParameterCount for 0, caso contrário, ele deverá ter elementos OutputLockedParameterCount .

Valor retornado

Retorna S_OK se tiver êxito, caso contrário, um código de erro.

Comentários

Uma vez bloqueada, a configuração de entrada e saída e quaisquer outros parâmetros bloqueados permanecem constantes até que UnLockForProcess seja chamado. Depois que um XAPO é bloqueado, outras chamadas para LockForProcess não têm efeito até que a função UnLockForProcess seja chamada.

Um XAPO indica quais formatos específicos ele dá suporte por meio de sua implementação dos métodos IsInputFormatSupported e IsOutputFormatSupported . Um XAPO deve afirmar que as configurações de entrada e saída têm suporte e que qualquer inicialização específica de efeito necessária está concluída. Os métodos IsInputFormatSupported, IsOutputFormatSupported e Initialize devem ser usados conforme necessário antes de chamar esse método.

Como Process é um método sem bloqueio, todos os buffers de memória internos necessários para Process devem ser alocados em LockForProcess.

O processo nunca é chamado antes que LockForProcess retorne com êxito.

LockForProcess é chamado diretamente pelo XAudio2 e não deve ser chamado pelo código do cliente.

Requisitos de plataforma

Requisitos

Confira também

IXAPO