Metodo IXAPO::LockForProcess (xapo.h)
Chiamato da XAudio2 per bloccare le configurazioni di input e output di un XAPO che consente di eseguire qualsiasi inizializzazione finale prima che il processo venga chiamato nel thread in tempo reale.
Sintassi
HRESULT LockForProcess(
UINT32 InputLockedParameterCount,
const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
UINT32 OutputLockedParameterCount,
const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);
Parametri
InputLockedParameterCount
Numero di elementi in ppInputLockedParameters. Deve trovarsi all'interno del XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount e XAPO_REGISTRATION_PROPERTIES. Valori MaxInputBufferCount passati a CXAPOBase::CXAPOBase.
pInputLockedParameters
Matrice di strutture di input XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS . pInputLockedParameters può essere NULL se InputLockedParameterCount è 0, altrimenti deve avere elementi InputLockedParameterCount .
OutputLockedParameterCount
Numero di elementi in ppOutputLockedParameters. Deve trovarsi all'interno del XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount e XAPO_REGISTRATION_PROPERTIES. Valori MaxOutputBufferCount passati a CXAPOBase::CXAPOBase. Se il flag di XAPO_FLAG_BUFFERCOUNT_MUST_MATCH è stato specificato in XAPO_REGISTRATION_PROPERTIES. I flag quindi OutputLockedParameterCount devono essere uguali a InputLockedParameterCount.
pOutputLockedParameters
Matrice di strutture di output XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS . pOutputLockedParameters può essere NULL se OutputLockedParameterCount è 0, altrimenti deve avere elementi OutputLockedParameterCount .
Valore restituito
Restituisce S_OK se ha esito positivo, in caso contrario, un codice di errore.
Commenti
Una volta bloccato, la configurazione di input e output e qualsiasi altro parametro bloccato rimane costante fino a quando non viene chiamato UnLockForProcess . Dopo che un XAPO è bloccato, le chiamate aggiuntive a LockForProcess non hanno alcun effetto finché non viene chiamata la funzione UnLockForProcess .
Un XAPO indica i formati specifici supportati tramite l'implementazione dei metodi IsInputFormatSupported e IsOutputFormatSupported . Un XAPO deve asserire le configurazioni di input e output supportate e che tutte le inizializzazione specifiche dell'effetto necessarie sono completate. I metodi IsInputFormatSupported, IsOutputFormatSupported e Initialize devono essere usati in base alle esigenze prima di chiamare questo metodo.
Poiché Process è un metodo non sbloccante, tutti i buffer di memoria interni necessari per Process devono essere allocati in LockForProcess.
Il processo non viene mai chiamato prima che LockForProcess restituisca correttamente.
LockForProcess viene chiamato direttamente da XAudio2 e non deve essere chiamato dal codice client.
Requisiti della piattaforma
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | xapo.h |