Méthode IDiscFormat2Data::Write (imapi2.h)
Écrit le flux de données sur l’appareil.
Syntaxe
HRESULT Write(
[in] IStream *data
);
Paramètres
[in] data
Interface IStream du flux de données à écrire.
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 :
| Code de retour | Description |
|---|---|
|
L’appareil n’a pas pu accepter la commande dans le délai d’expiration. Cela peut être dû au fait que l’appareil a entré un état incohérent ou que la valeur du délai d’expiration de la commande doit être augmentée.
Valeur : 0xC0AA020D |
|
L’appareil a signalé des données inattendues ou non valides pour une commande.
Valeur : 0xC0AA02FF |
|
Le média est inséré à l’envers.
Valeur : 0xC0AA0204 |
|
Le lecteur a signalé qu’il est en train de se préparer. Veuillez réessayer la demande ultérieurement.
Valeur : 0xC0AA0205 |
|
Il n’y a aucun média dans l’appareil.
Valeur : 0xC0AA0202 |
|
Le média est en cours de mise en forme. Attendez que le format se termine avant d’essayer d’utiliser le média.
Valeur : 0xC0AA0206 |
|
Le lecteur a signalé qu’il effectuait une opération de longue durée, comme la fin d’une écriture. Le lecteur peut être inutilisable pendant une longue période.
Valeur : 0xC0AA0207 |
|
L’écriture a échoué, car le lecteur n’a pas reçu les données assez rapidement pour continuer l’écriture. Le déplacement des données sources vers l’ordinateur local, la réduction de la vitesse d’écriture ou l’activation d’un paramètre « sans exécution de mémoire tampon » peut résoudre ce problème.
Valeur : 0xC0AA0300 |
|
Le média n’est pas compatible ou de format physique inconnu.
Valeur : 0xC0AA0203 |
|
La structure DVD n’est pas présente. Cela peut être dû à l’utilisation d’un lecteur/d’un support incompatible.
Valeur : 0xC0AA020E |
|
L’appareil a signalé que la page du mode demandé (et le type) n’est pas présent.
Valeur : 0xC0AA0201 |
|
Le lecteur a signalé que la combinaison de paramètres fournie dans la page de mode d’une commande MODE SELECT n’était pas prise en charge.
Valeur : 0xC0AA0208 |
|
Le lecteur a signalé que le média est protégé en écriture.
Valeur : 0xC0AA0209 |
|
La vitesse du média n’est pas compatible avec l’appareil. Cela peut être dû à l’utilisation d’un média de vitesse supérieure ou inférieure à la plage de vitesses prise en charge par l’appareil.
Valeur : 0xC0AA020F |
|
Le handle spécifié n’est pas valide.
Valeur : 6 |
|
La ressource réseau ou le périphérique spécifié n’est plus disponible.
Valeur : 55 |
|
L’appareil associé à cet enregistreur lors de la dernière opération a été exclusivement verrouillé, ce qui a entraîné l’échec de cette opération.
Valeur : 0xC0AA0210 |
|
L’écriture a échoué, car le lecteur a retourné des informations d’erreur qui n’ont pas pu être récupérées.
Valeur : 0xC0AA0301 |
|
La demande nécessite la sélection d’un enregistreur de disque actif.
Valeur : 0xC0AA0003 |
|
Le type de rotation demandé n’était pas pris en charge par le lecteur et le type de rotation a été ajusté.
Valeur : 0x00AA0005 |
|
La vitesse d’écriture demandée n’était pas prise en charge par le lecteur et la vitesse a été ajustée.
Valeur : 0x00AA0004 |
|
La vitesse d’écriture et le type de rotation demandés n’étaient pas pris en charge par le lecteur et ils ont tous deux été ajustés.
Valeur : 0x00AA0006 |
|
Cet appareil ne prend pas en charge les opérations requises par ce format de disque.
Valeur : 0xC0AA0407 |
|
La demande a été annulée.
Valeur : 0xC0AA0002 |
|
Une opération d’écriture est actuellement en cours.
Valeur : 0xC0AA0400 |
|
La taille de l’objet IStream fourni n’est pas valide. La taille doit être un multiple de la taille du secteur, 2048.
Valeur : 0xC0AA0403 |
|
Le type de média actuel n’est pas pris en charge.
Valeur : (HRESULT)0xC0AA0406 |
|
Un ou plusieurs arguments ne sont pas valides.
Valeur : 0x80070057 |
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Défaillance non spécifiée.
Valeur : 0x80004005 |
|
Échec de l’allocation de la mémoire requise.
Valeur : 0x8007000E |
|
Non implémenté.
Valeur : 0x80004001 |
Notes
Avant d’appeler cette méthode, vous devez appeler les méthodes suivantes :
Vous devez également envisager d’appeler les méthodes suivantes si leurs valeurs par défaut ne conviennent pas à votre application :- IDiscFormat2Data::p ut_BufferUnderrunFreeDisabled
- IDiscFormat2Data::p ut_DisableConsumerDvdCompatibilityMode
- IDiscFormat2Data::p ut_ForceMediaToBeClosed
- IDiscFormat2Data::p ut_ForceOverwrite
- IDiscFormat2Data::p ut_PostgapAlreadyInImage
- IDiscFormat2Data::SetWriteSpeed
Sur les disques enregistrés séquentiellement, l’IStream fourni est enregistré en tant que nouvelle session. Sur les disques réinscriptibles, l’IStream fourni est toujours enregistré à partir du secteur 0, mais l’objet fournissant l’interface IStream peut également fournir l’interface IBlockRangeList répertoriant les secteurs qui doivent être enregistrés. L’interface IBlockRangeList est utilisée pour éviter la réécriture de secteurs qui n’ont pas changé dans les scénarios multisession. Si l’objet qui fournit IStream ne fournit pas IBlockRangeList, il est supposé que l’ensemble de l’IStream doit être enregistré.
Configuration requise
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2.h |