Metodo IDiscMaster::EnumDiscRecorders (imapi.h)

Recupera un enumeratore per tutti i registratori di dischi supportati dal formato master del disco attivo.

Sintassi

HRESULT EnumDiscRecorders(
  [out] IEnumDiscRecorders **ppEnum
);

Parametri

[out] ppEnum

Indirizzo di un puntatore all'enumeratore IEnumDiscRecorders .

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

IEnumDiscRecorders è un enumeratore COM standard, come documentato in IEnumXXXX. Ogni chiamata a Next restituisce una matrice di puntatori a IDiscRecorder. Ogni interfaccia di registrazione rappresenta un singolo registratore disponibile già associato a un registratore disco fisico sottostante.

L'elenco dei registratori disponibili può cambiare a causa degli arrivi o delle partenza di Plug and Play o di una chiamata a SetActiveDiscMasterFormat. Un'applicazione riceve una notifica di queste modifiche quando riceve una chiamata a IDiscMasterProgressEvents::NotifyPnPActivity. Quando si verifica una modifica, l'applicazione deve chiamare nuovamente questo metodo per recuperare un nuovo enumeratore, perché ogni enumeratore contiene uno snapshot dei dispositivi supportati al momento dell'enumerazione.

Quando un dispositivo viene rimosso, il puntatore e l'interfaccia IDiscRecorder devono rimanere validi anche se il dispositivo fisico sottostante manca. In questo caso, le operazioni su un IDiscRecorder o su una richiesta per registrare un disco possono restituire IMAPI_E_DEVICE_NOTPRESENT.

La proprietà MaxWriteSpeed viene aggiornata quando questo metodo viene chiamato. L'impostazione predefinita è la velocità di scrittura più elevata disponibile.

Requisiti

Vedi anche

IDiscMaster