Metodo IDiscRecorder2Ex::GetDiscInformation (imapi2.h)
Recupera le informazioni sul disco dai supporti.
Sintassi
HRESULT GetDiscInformation(
[out] BYTE **discInformation,
[out] ULONG_IMAPI2_DISC_INFORMATION *byteSize
);
Parametri
[out] discInformation
Buffer di dati che contiene informazioni sul disco dal supporto. Per informazioni dettagliate sul contenuto del buffer dati, vedere il comando READ DISC INFORMATION nella revisione più recente della specifica MMC in ftp://ftp.t10.org/t10/drafts/mmc5.
Al termine, chiamare la funzione CoTaskMemFree per liberare la memoria.
[out] byteSize
Dimensioni, in byte, del buffer di dati.
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 |
|---|---|
|
Puntatore non valido.
Valore: 0x80004003 |
|
Errore non specificato.
Valore: 0x80004005 |
|
Impossibile allocare la memoria necessaria.
Valore: 0x8007000E |
|
Il dispositivo non è riuscito a accettare il comando entro il periodo di timeout. Questo può essere causato dal dispositivo che ha immesso uno stato incoerente o il valore di timeout per il comando potrebbe essere aumentato.
Valore: 0xC0AA020D |
|
Il dispositivo ha segnalato dati imprevisti o non validi per un comando.
Valore: 0xC0AA02FF |
|
Il supporto viene inserito sottosopra.
Valore: 0xC0AA0204 |
|
L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento.
Valore: 0xC0AA0205 |
|
Nel dispositivo non sono presenti supporti.
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 esegue un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità potrebbe non essere utilizzabile per un lungo periodo di tempo.
Valore: 0xC0AA0207 |
|
La scrittura non è riuscita perché l'unità non ha ricevuto i dati abbastanza rapidamente per continuare a scrivere. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer in esecuzione gratuita" può risolvere questo problema.
Valore: 0xC0AA0300 |
|
Il supporto non è compatibile o di formato fisico sconosciuto.
Valore: 0xC0AA0203 |
|
La struttura DVD non è presente. Ciò può essere causato da unità/media incompatibili usate.
Valore: 0xC0AA020E |
|
Il dispositivo ha segnalato che la pagina della 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. Questo 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 specificati non sono più disponibili.
Valore: 55 |
|
Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'errore di questa operazione.
Valore: 0xC0AA0210 |
Commenti
Per informazioni dettagliate su come interpretare i dati restituiti, vedere la specifica MMC.
Requisiti
| 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 |