Metodo IAudioProcessingObject::Initialize (audioenginebaseapo.h)

Il metodo Initialize inizializza l'apo e supporta i dati di lunghezza variabile.

Sintassi

HRESULT Initialize(
  [in] UINT32 cbDataSize,
  [in] BYTE   *pbyData
);

Parametri

[in] cbDataSize

Si tratta delle dimensioni, in byte, dei dati di inizializzazione.

[in] pbyData

Si tratta di dati di inizializzazione specifici per questo apo.

Valore restituito

Il Initialize metodo restituisce un valore di S_OK se la chiamata ha avuto esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore seguenti:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido passato alla funzione.
E_INVALIDARG	Argomento non valido.
APOERR_ALREADY_INITIALIZED	APO già inizializzato.
Altri VALORI HRESULT	Queste condizioni di errore aggiuntive vengono rilevate dal motore audio.

Commenti

Se questo metodo viene usato per inizializzare un oggetto APO senza la necessità di inizializzare dati, è accettabile fornire un valore NULL come valore del parametro pbyData e 0 (zero) come valore del parametro cbDataSize. I dati forniti sono di lunghezza variabile e devono avere il formato seguente:

Struct MyAPOInitializationData
{
APOInitBaseStruct APOInit;
// list additional struct members here
// ...
};

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile con Windows Vista e sistemi operativi Windows successivi.
Piattaforma di destinazione	Universale
Intestazione	audioenginebaseapo.h
Libreria	Audioenginebaseapo.idl
IRQL	Qualsiasi livello

Vedi anche

APOInitBaseStruct