Metodo IDiscRecorder2Ex::ReadStructure (imapi2.h)
Legge una struttura DVD dal supporto.
Sintassi
HRESULT ReadDvdStructure(
[in] ULONG format,
[in] ULONG address,
[in] ULONG layer,
[in] ULONG agid,
[out] BYTE **data,
[out] ULONG_IMAPI2_DVD_STRUCTURE *count
);
Parametri
[in] format
Campo Formato del pacchetto di comando. I valori accettabili sono compresi tra zero e 0xFF.
[in] address
Campo indirizzo del pacchetto di comando.
[in] layer
Campo livello del pacchetto di comando.
[in] agid
Campo ID concessione di autenticazione (AGID) del pacchetto di comando.
[out] data
Buffer di dati che contiene la struttura DVD. Per informazioni dettagliate sul contenuto del buffer di dati, vedere il comando READ DISC STRUCTURE nella revisione più recente della specifica MMC in ftp://ftp.t10.org/t10/drafts/mmc5.
Questo metodo rimuove le intestazioni dal buffer.
Al termine, chiamare la funzione CoTaskMemFree per liberare la memoria.
[out] count
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 |
|
L'unità non supporta il comando GET CONFIGURATION.
Valore: 0xC0AA020C |
|
La pagina di funzionalità richiesta non è supportata dal dispositivo.
Valore: 0xC0AA020A |
|
Impossibile allocare la memoria richiesta.
Valore: 0x8007000E |
|
La pagina di funzionalità richiesta è supportata, ma non è contrassegnata come corrente.
Valore: 0xC0AA020B |
|
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 |
|
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: 0xC0AA020E |
Commenti
Questo metodo rimuove la complessità dell'uso del comando READ DISC STRUCTURE. Per informazioni dettagliate sui valori da specificare per il formato, l'indirizzo, il livello e i parametri agid , vedere le descrizioni dei campi per il comando READ DISC STRUCTURE nella revisione più recente della specifica MMC in ftp://ftp.t10.org/t10/drafts/mmc5.
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 |