Método IDiscRecorder2Ex::ReadDvdStructure (imapi2.h)

Lê uma estrutura de DVD da mídia.

Sintaxe

HRESULT ReadDvdStructure(
  [in]  ULONG                      format,
  [in]  ULONG                      address,
  [in]  ULONG                      layer,
  [in]  ULONG                      agid,
  [out] BYTE                       **data,
  [out] ULONG_IMAPI2_DVD_STRUCTURE *count
);

Parâmetros

[in] format

Campo Formatar do pacote de comando. Os valores aceitáveis variam de zero a 0xFF.

Nota Esse valor é truncado para UCHAR.

 

[in] address

Campo de endereço do pacote de comando.

[in] layer

Campo camada do pacote de comando.

[in] agid

Campo AGID (ID de concessão de autenticação) do pacote de comando.

[out] data

Buffer de dados que contém a estrutura de DVD. Para obter detalhes sobre o conteúdo do buffer de dados, consulte o comando READ DISC STRUCTURE na revisão mais recente da especificação do MMC em ftp://ftp.t10.org/t10/drafts/mmc5.

Esse método remove cabeçalhos do buffer.

Quando terminar, chame a função CoTaskMemFree para liberar a memória.

[out] count

Tamanho, em bytes, do buffer de dados.

Retornar valor

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_FAIL	Falha não especificada. Valor: 0x80004005
E_IMAPI_RECORDER_GET_CONFIGURATION_NOT_SUPPORTED	A unidade não dá suporte ao comando GET CONFIGURATION. Valor: 0xC0AA020C
E_IMAPI_RECORDER_NO_SUCH_FEATURE	Não há suporte para a página de recursos solicitada pelo dispositivo. Valor: 0xC0AA020A
E_OUTOFMEMORY	Falha ao alocar a memória necessária. Valor: 0x8007000E
E_IMAPI_RECORDER_FEATURE_IS_NOT_CURRENT	Há suporte para a página de recursos solicitada, mas não está marcada como atual. Valor: 0xC0AA020B
E_IMAPI_RECORDER_COMMAND_TIMEOUT	O dispositivo não aceitou o comando dentro do período de tempo limite. Isso pode ser causado pelo dispositivo ter inserido um estado inconsistente ou o valor de tempo limite para o comando pode precisar ser aumentado. Valor: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	O dispositivo relatou dados inesperados ou inválidos para um comando. Valor: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	A mídia é inserida de cabeça para baixo. Valor: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	A unidade informou que está em processo de preparação. Tente a solicitação novamente mais tarde. Valor: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Não há mídia no dispositivo. Valor: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	A mídia está sendo formatada no momento. Aguarde a conclusão do formato antes de tentar usar a mídia. Valor: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	A unidade informou que está executando uma operação de longa execução, como terminar uma gravação. A unidade pode ser inutilizável por um longo período de tempo. Valor: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	A gravação falhou porque a unidade não recebeu dados rapidamente o suficiente para continuar gravando. Mover os dados de origem para o computador local, reduzir a velocidade de gravação ou habilitar uma configuração de "buffer sem execução livre" pode resolve esse problema. Valor: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	A mídia não é compatível ou de formato físico desconhecido. Valor: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	A estrutura do DVD não está presente. Isso pode ser causado por uma unidade/meio incompatível usada. Valor: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	O dispositivo informou que a página do modo solicitado (e o tipo) não está presente. Valor: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	A unidade informou que não havia suporte para a combinação de parâmetros fornecidos na página de modo para um comando MODE SELECT. Valor: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	A unidade informou que a mídia está protegida por gravação. Valor: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	A velocidade da mídia é incompatível com o dispositivo. Isso pode ser causado pelo uso de mídia de velocidade maior ou menor do que o intervalo de velocidades com suporte do dispositivo. Valor: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	O identificador especificado é inválido. Valor: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	O recurso de rede ou dispositivo especificado não está mais disponível. Valor: 55
E_IMAPI_RECORDER_LOCKED	O dispositivo associado a esse gravador durante a última operação foi bloqueado exclusivamente, fazendo com que essa operação falhasse. Valor: 0xC0AA0210
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	O dispositivo não aceitou o comando dentro do período de tempo limite. Isso pode ser causado pelo dispositivo ter inserido um estado inconsistente ou o valor de tempo limite para o comando pode precisar ser aumentado. Valor: 0xC0AA020E

Comentários

Esse método remove a complexidade de trabalhar com o comando READ DISC STRUCTURE. Para obter detalhes sobre os valores a serem especificados para os parâmetros format, address, layer e agid , consulte suas descrições de campo para o comando READ DISC STRUCTURE na revisão mais recente da especificação do MMC em ftp://ftp.t10.org/t10/drafts/mmc5.

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

Confira também

IDiscRecorder2Ex

IDiscRecorder2Ex::SendDvdStructure