Share via

Método IDvdInfo2::GetDiscID (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetDiscID método recupera um número de identificação de 64 bits gerado pelo sistema para o DVD especificado.

Sintaxe

HRESULT GetDiscID(
  [in]  LPCWSTR   pszwPath,
  [out] ULONGLONG *pullDiscID
);

Parâmetros

[in] pszwPath

Caminho do volume a ser usado para a ID do disco. Especifique NULL para usar o volume de DVD atual ou padrão.

[out] pullDiscID

Recebe a ID do disco de 64 bits.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 Argumento inválido.
E_UNEXPECTED
 O Navegador de DVD não é inicializado.
VFW_E_DVD_INVALID_DISC
 O caminho especificado não é um disco de DVD válido.

Comentários

O Navegador de DVD calcula uma ID do identificador com base em tamanhos de arquivo, datas e outras informações, e não no valor BCA (área de corte de intermitência). Esse número é garantido para ser o mesmo sempre que o disco é reproduzido. A ID se aplica a todas as cópias replicadas de um disco. Em outras palavras, todas as cópias de um filme específico terão a mesma ID. As chances de dois títulos separados terem a mesma ID são suficientemente remotas de que essa ID possa ser considerada "exclusiva" para todos os fins práticos.

Requisitos

   
Cliente mínimo com suporte Windows XP [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 strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdInfo2 Interface