Metodo IDiscRecorder2::InitializeDiscRecorder (imapi2.h)
Associa l'oggetto al dispositivo disco specificato.
Sintassi
HRESULT InitializeDiscRecorder(
[in] BSTR recorderUniqueId
);
Parametri
[in] recorderUniqueId
Stringa contenente l'identificatore univoco per il dispositivo.
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:
| Codice restituito | Descrizione |
|---|---|
|
Uno o più argomenti non sono validi.
Valore: 0x80070057 |
|
Il valore in cchDest è 0 o maggiore di STRSAFE_MAX_CCH. |
|
Errore non specificato.
Valore: 0x80004005 |
|
Impossibile allocare la memoria richiesta.
Valore: 0x8007000E |
|
Il dispositivo non è riuscito ad accettare il comando entro il periodo di timeout. Ciò può essere causato dall'immissione di uno stato incoerente del dispositivo oppure potrebbe essere necessario aumentare il valore di timeout per il comando.
Valore: 0xC0AA020D |
|
Il dispositivo ha segnalato dati imprevisti o non validi per un comando.
Valore: 0xC0AA02FF |
|
Il supporto viene inserito a capovolto.
Valore: 0xC0AA0204 |
|
L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento.
Valore: 0xC0AA0205 |
|
Non sono presenti supporti nel dispositivo.
Valore: 0xC0AA0202 |
|
Il supporto è attualmente formattato. Attendere il completamento del formato prima di tentare di usare il supporto.
Valore: 0xC0AA0206 |
|
L'unità ha segnalato che sta eseguendo un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità può essere inutilizzabile per un lungo periodo di tempo.
Valore: 0xC0AA0207 |
|
La scrittura non è riuscita perché l'unità non ha ricevuto dati abbastanza rapidamente per continuare la scrittura. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer underrun free" può risolvere questo problema.
Valore: 0xC0AA0300 |
|
Il supporto non è compatibile o con un formato fisico sconosciuto.
Valore: 0xC0AA0203 |
|
La struttura DVD non è presente. Ciò può essere causato dall'uso di unità/supporto incompatibili.
Valore: 0xC0AA020E |
|
Il dispositivo ha segnalato che la pagina in modalità richiesta (e tipo) non è presente.
Valore: 0xC0AA0201 |
|
L'unità ha segnalato che la combinazione di parametri forniti nella pagina della modalità per un comando MODE SELECT non è supportata.
Valore: 0xC0AA0208 |
|
L'unità ha segnalato che il supporto è protetto da scrittura.
Valore: 0xC0AA0209 |
|
La velocità del supporto non è compatibile con il dispositivo. Ciò può essere causato dall'uso di supporti di velocità superiori o inferiori rispetto all'intervallo di velocità supportato dal dispositivo.
Valore: 0xC0AA020F |
|
L'handle specificato non è valido.
Valore: 6 |
|
La risorsa di rete o il dispositivo specificato non sono più disponibili.
Valore: 55 |
|
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'esito negativo di questa operazione.
Valore: 0xC0AA0210 |
Commenti
È necessario inizializzare il registratore prima di chiamare uno dei metodi di questa interfaccia.
Per recuperare un elenco di dispositivi nel computer e i relativi identificatori univoci, chiamare il metodo IDiscMaster2::get__NewEnum .
Questo metodo non avrà esito negativo in un'unità bloccata esclusivamente. Tuttavia, se l'unità è bloccata esclusivamente, diversi metodi di questa interfaccia possono restituire E_IMAPI_RECORDER_LOCKED. Per determinare chi ha accesso esclusivo, chiamare il metodo IDiscRecorder2::get_ExclusiveAccessOwner .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2.h |