Compartilhar via


Método IDiscFormat2::IsCurrentMediaSupported (imapi2.h)

Determina se a mídia atual em um gravador com suporte dá suporte ao formato especificado.

Sintaxe

HRESULT IsCurrentMediaSupported(
  [in]  IDiscRecorder2 *recorder,
  [out] VARIANT_BOOL   *value
);

Parâmetros

[in] recorder

Uma interface IDiscRecorder2 do gravador a ser testado.

[out] value

Será VARIANT_TRUE se a mídia no gravador der suporte ao formato determinado; caso contrário, VARIANT_FALSE.

Nota VARIANT_TRUE também implica que o resultado de IsDiscRecorderSupported é VARIANT_TRUE.
 

Retornar valor

S_OK ou S_FALSE são retornados com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente 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_IMAPI_RECORDER_MEDIA_NO_MEDIA
Não há mídia no dispositivo.

(HRESULT)0xC0AA0202

 
Nota Atualmente, o Windows Vista retornará S_OK e VARIANT_FALSE quando a mídia não estiver presente no dispositivo, enquanto E_IMAPI_RECORDER_MEDIA_NO_MEDIA e VARIANT_FALSE são retornados no Windows 7.
 

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

IDiscFormat2

IDiscFormat2::IsDiscRecorderSupported