Método IWriteEngine2::WriteSection (imapi2.h)

Artigo
08/24/2023

Grava um fluxo de dados no gravador atual.

Sintaxe

HRESULT WriteSection(
  [in] IStream *data,
  [in] LONG    startingBlockAddress,
  [in] LONG    numberOfBlocks
);

Parâmetros

[in] data

Uma interface IStream do fluxo de dados a ser gravada no gravador.

[in] startingBlockAddress

Iniciando o LBA (endereço de bloco lógico) da operação de gravação. Há suporte para valores negativos.

[in] numberOfBlocks

Número de blocos do fluxo de dados a serem gravados.

Valor retornado

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno	Descrição
E_POINTER	O ponteiro não é válido. Valor: 0x80004003
E_OUTOFMEMORY	Falha ao alocar a memória necessária. Valor: 0x8007000E
E_INVALIDARG	Um ou mais argumentos não são válidos. Valor: 0x80070057
E_IMAPI_REQUEST_CANCELLED	A solicitação foi cancelada. Valor: 0xC0AA0002

Comentários

Antes de chamar esse método, você deve chamar o método IWriteEngine2::p ut_Recorder para especificar o dispositivo de gravação e o método IWriteEngine2::p ut_BytesPerSector para especificar o número de bytes a serem usados para cada setor durante a gravação.

Você também deve considerar chamar os seguintes métodos se seus valores padrão não forem apropriados para seu aplicativo:

Esse método é síncrono. Para determinar o progresso da operação de gravação, você deve implementar a interface DWriteEngine2Events . Para obter exemplos que mostram como implementar um manipulador de eventos em um script, consulte Monitoramento de progresso com eventos.

Requisitos


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