Interfaccia IWriteEngine2 (imapi2.h)

Articolo
08/24/2023

Usare questa interfaccia per scrivere un flusso di dati in un dispositivo.

Questa interfaccia deve essere usata da coloro che sviluppano il supporto per nuovi tipi di supporti o formati. La scrittura nei supporti include in genere i passaggi seguenti:

Preparazione dell'hardware impostando le pagine in modalità per i supporti.
Esecuzione di query sull'hardware per verificare che il supporto sia sufficiente.
Inizializzazione della scrittura, ad esempio, formattando il supporto o impostando OPC.
Esecuzione dei comandi WRITE effettivi.
Completamento della scrittura arrestando la formattazione o chiudendo la sessione o la traccia.

Quando si sviluppa il supporto per nuovi tipi di supporti, è possibile implementare i passaggi 1, 2, 3 e 5 e usare questa interfaccia per eseguire il passaggio 4. Si noti che tutte le interfacce IDiscFormat2* usano questa interfaccia per eseguire l'operazione di scrittura.

La maggior parte delle applicazioni client deve usare l'interfaccia IDiscFormat2Data per scrivere immagini in un dispositivo.

Per creare un'istanza di questa interfaccia, chiamare la funzione CoCreateInstance . Use__uuidof(MsftWriteEngine2) per l'identificatore di classe e __uuidof(IWriteEngine2) per l'identificatore dell'interfaccia.

Ereditarietà

L'interfaccia IWriteEngine2 eredita dall'interfaccia IDispatch . IWriteEngine2 include anche questi tipi di membri:

Metodi

L'interfaccia IWriteEngine2 include questi metodi.


IWriteEngine2::CancelWrite Annulla un'operazione di scrittura in corso.
IWriteEngine2::get_BytesPerSector Recupera il numero di byte da usare per ogni settore durante la scrittura. Il valore restituito indica il valore precedentemente impostato con IWriteEngine2::p ut_BytesPerSector e non restituisce un byte corrente per ogni valore del settore per supporto.
IWriteEngine2::get_EndingSectorsPerSecond Recupera il numero stimato di settori al secondo in cui il dispositivo di registrazione può scrivere nel supporto alla fine del processo di scrittura.
IWriteEngine2::get_Recorder Recupera il dispositivo di registrazione da usare nell'operazione di scrittura.
IWriteEngine2::get_StartingSectorsPerSecond Recupera il numero stimato di settori al secondo in cui il dispositivo di registrazione può scrivere nel supporto all'inizio del processo di scrittura.
IWriteEngine2::get_UseStreamingWrite12 Recupera un valore che indica se le operazioni di scrittura usano il comando WRITE12 o WRITE10.
IWriteEngine2::get_WriteInProgress Recupera un valore che indica se il registratore sta attualmente scrivendo dati nel disco.
IWriteEngine2::p ut_BytesPerSector Imposta il numero di byte da usare per ogni settore durante la scrittura.
IWriteEngine2::p ut_EndingSectorsPerSecond Imposta il numero stimato di settori al secondo in cui il dispositivo di registrazione può scrivere nel supporto alla fine del processo di scrittura.
IWriteEngine2::p ut_Recorder Imposta un dispositivo di registrazione per l'operazione di scrittura.
IWriteEngine2::p ut_StartingSectorsPerSecond Imposta il numero stimato di settori al secondo in cui il dispositivo di registrazione può scrivere nel supporto all'inizio del processo di scrittura.
IWriteEngine2::p ut_UseStreamingWrite12 Imposta un valore che indica se le operazioni di scrittura usano il comando WRITE12 o WRITE10.
IWriteEngine2::WriteSection Scrive un flusso di dati nel registratore corrente.

Commenti

Per creare l'oggetto MsftWriteEngine2 in uno script, usare IMAPI2. MsftWriteEngine2 come identificatore del programma quando si chiama CreateObject.

È possibile che una transizione dello stato di alimentazione venga eseguita durante un'operazione di burn (ad esempio la sospensione del log dell'utente o la sospensione del sistema) che comporta l'interruzione del processo di burn e la possibile perdita di dati. Per considerazioni sulla programmazione, vedere Prevenzione del logoff o sospensione durante un burn.

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