Método IDiscRecorder::QueryMediaInfo (imapi.h)
Recupera informações sobre a mídia montada no momento, como o número total de blocos usados na mídia.
Sintaxe
HRESULT QueryMediaInfo(
[out] byte *pbSessions,
[out] byte *pbLastTrack,
[out] ULONG *ulStartAddress,
[out] ULONG *ulNextWritable,
[out] ULONG *ulFreeBlocks
);
Parâmetros
[out] pbSessions
Número de sessões no disco.
[out] pbLastTrack
Acompanhe o número da última faixa da sessão anterior.
[out] ulStartAddress
Endereço inicial da última faixa da sessão anterior.
[out] ulNextWritable
Endereço no qual a gravação deve começar.
[out] ulFreeBlocks
Número de blocos disponíveis para gravação.
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 normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
Comentários
O uso desse método permite o cálculo de parâmetros como a quantidade de espaço livre restante no disco sem usar uma configuração no gravador de disco ativo, o que causa uma abertura exclusiva. O tamanho total do disco pode ser calculado somando o próximo endereço gravável e blocos livres.
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 | imapi.h |
| Biblioteca | Uuid.lib |
| DLL | Actxprxy.dll |