Interface IWriteEngine2 (imapi2.h)

Artigo
08/24/2023

Use essa interface para gravar um fluxo de dados em um dispositivo.

Essa interface deve ser usada por aqueles que desenvolvem suporte para novos tipos de mídia ou formatos. A gravação em mídia normalmente inclui as seguintes etapas:

Preparando o hardware definindo páginas de modo para a mídia.
Consultar o hardware para verificar se a mídia é grande o suficiente.
Inicializando a gravação, por exemplo, formatando a mídia ou definindo OPC.
Executando os comandos WRITE reais.
Concluindo a gravação parando a formatação ou fechando a sessão ou a faixa.

Ao desenvolver suporte para novos tipos de mídia, você pode implementar as etapas 1, 2, 3 e 5 e usar essa interface para executar a etapa 4. Observe que todas as interfaces IDiscFormat2* usam essa interface para executar a operação de gravação.

A maioria dos aplicativos cliente deve usar a interface IDiscFormat2Data para gravar imagens em um dispositivo.

Para criar uma instância dessa interface, chame a função CoCreateInstance . Use__uuidof(MsftWriteEngine2) para o identificador de classe e __uuidof(IWriteEngine2) para o identificador de interface.

Herança

A interface IWriteEngine2 herda da interface IDispatch . IWriteEngine2 também tem estes tipos de membros:

Métodos

A interface IWriteEngine2 tem esses métodos.


IWriteEngine2::CancelWrite Cancela uma operação de gravação em andamento.
IWriteEngine2::get_BytesPerSector Recupera o número de bytes a serem usados para cada setor durante a gravação. O valor retornado indica qual valor definido anteriormente com IWriteEngine2::p ut_BytesPerSector e não retorna um valor de bytes atuais por setor para mídia.
IWriteEngine2::get_EndingSectorsPerSecond Recupera o número estimado de setores por segundo que o dispositivo de gravação pode gravar na mídia no final do processo de gravação.
IWriteEngine2::get_Recorder Recupera o dispositivo de gravação a ser usado na operação de gravação.
IWriteEngine2::get_StartingSectorsPerSecond Recupera o número estimado de setores por segundo que o dispositivo de gravação pode gravar na mídia no início do processo de gravação.
IWriteEngine2::get_UseStreamingWrite12 Recupera um valor que indica se as operações de gravação usam o comando WRITE12 ou WRITE10.
IWriteEngine2::get_WriteInProgress Recupera um valor que indica se o gravador está gravando dados no disco no momento.
IWriteEngine2::p ut_BytesPerSector Define o número de bytes a serem usados para cada setor durante a gravação.
IWriteEngine2::p ut_EndingSectorsPerSecond Define o número estimado de setores por segundo que o dispositivo de gravação pode gravar na mídia no final do processo de gravação.
IWriteEngine2::p ut_Recorder Define um dispositivo de gravação para a operação de gravação.
IWriteEngine2::p ut_StartingSectorsPerSecond Define o número estimado de setores por segundo que o dispositivo de gravação pode gravar na mídia no início do processo de gravação.
IWriteEngine2::p ut_UseStreamingWrite12 Define um valor que indica se as operações de gravação usam o comando WRITE12 ou WRITE10.
IWriteEngine2::WriteSection Grava um fluxo de dados no gravador atual.

Comentários

Para criar o objeto MsftWriteEngine2 em um script, use IMAPI2. MsftWriteEngine2 como o identificador do programa ao chamar CreateObject.

É possível que uma transição de estado de energia ocorra durante uma operação de gravação (ou seja, logoff do usuário ou suspensão do sistema), o que leva à interrupção do processo de gravação e à possível perda de dados. Para considerações sobre programação, consulte Impedindo logoff ou Suspender durante uma gravação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	imapi2.h