Méthode IDiscRecorder::QueryMediaInfo (imapi.h)

Article
08/24/2023

Récupère des informations sur le média actuellement monté, telles que le nombre total de blocs utilisés sur le média.

Syntaxe

HRESULT QueryMediaInfo(
  [out] byte  *pbSessions,
  [out] byte  *pbLastTrack,
  [out] ULONG *ulStartAddress,
  [out] ULONG *ulNextWritable,
  [out] ULONG *ulFreeBlocks
);

Paramètres

[out] pbSessions

Nombre de sessions sur le disque.

[out] pbLastTrack

Numéro de suivi de la dernière piste de la session précédente.

[out] ulStartAddress

Adresse de début de la dernière piste de la session précédente.

[out] ulNextWritable

Adresse à laquelle l’écriture doit commencer.

[out] ulFreeBlocks

Nombre de blocs disponibles pour l’écriture.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Notes

L’utilisation de cette méthode permet de calculer des paramètres tels que la quantité d’espace libre restant sur le disque sans utiliser de paramètre sur l’enregistreur de disque actif, ce qui provoque une ouverture exclusive. La taille totale du disque peut être calculée en additionnant l’adresse accessible en écriture suivante et les blocs libres.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi.h
Bibliothèque	Uuid.lib
DLL	Actxprxy.dll

Voir aussi

IDiscRecorder

Partager via