Metodo IDiscMaster::SetActiveDiscMasterFormat (imapi.h)

Imposta il formato registratore dischi attualmente attivo. Il formato attivo specifica sia la struttura del contenuto del file di immagine di gestione temporanea (audio/dati) sia l'interfaccia COM che deve essere usata per modificare l'immagine di staging.

Sintassi

HRESULT SetActiveDiscMasterFormat(
  [in]  REFIID riid,
  [out] void   **ppUnk
);

Parametri

[in] riid

IID del formato attualmente attivo.

[out] ppUnk

Puntatore all'interfaccia COM per il nuovo formato del disco.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Commenti

Una chiamata riuscita a questo metodo cancella il contenuto dell'immagine attualmente gestita. Inoltre, può modificare l'elenco dei registratori di dischi supportati. Questo perché non tutti i registratori supportano tutti i formati. Le modifiche apportate all'elenco di registrazione vengono annunciate con IDiscMasterProgressEvents::NotifyPnPActivity. Se il registratore attualmente selezionato non è un membro del nuovo set di dispositivi supportati, non sarà più presente un registratore attivo (simile allo stato dopo la prima chiamata a Open). In questo caso, l'applicazione deve selezionare un nuovo registratore attivo prima di avviare una bruciatura.

MSDiscMasterObj supporta solo i seguenti ID: IID_IRedbookDiscMaster (IRedbookDiscMaster) e IID_IJolietDiscMaster (IJolietDiscMaster). Se non è impostato alcun formato, l'impostazione predefinita è Il formato Eseguet. È responsabilità di ogni applicazione selezionare un master di formato tramite l'uso di EnumDiscMasterFormats e questo metodo.

Requisiti

Vedi anche

IDiscMaster