Condividi tramite


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