Méthode IDiscFormat2Data::SetWriteSpeed (imapi2.h)
Définit la vitesse d’écriture de l’enregistreur de disque.
Syntaxe
HRESULT SetWriteSpeed(
[in] LONG RequestedSectorsPerSecond,
[in] VARIANT_BOOL RotationTypeIsPureCAV
);
Paramètres
[in] RequestedSectorsPerSecond
Vitesse d’écriture demandée mesurée en secteurs de disque par seconde.
Valeur de 0xFFFFFFFF (-1) demande que l’écriture se produise à l’aide de la vitesse prise en charge la plus rapide pour le média. Il s’agit de la valeur par défaut.
[in] RotationTypeIsPureCAV
Type de contrôle de vitesse de rotation demandé. Définissez sur VARIANT_TRUE pour demander le type de contrôle de vitesse de rotation de vitesse angulaire constante (CAV). Défini sur VARIANT_FALSE pour utiliser un autre type de contrôle de vitesse de rotation pris en charge par l’enregistreur. La valeur par défaut est VARIANT_FALSE.
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 |
|---|---|
|
La demande nécessite qu’un enregistreur de disque actif soit sélectionné.
Valeur : 0xC0AA0003 |
|
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 |
|
L’appareil n’a pas pu accepter la commande dans le délai imparti. Cela peut être dû au fait que l’appareil est entré dans 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 cours de préparation. Veuillez réessayer la demande ultérieurement.
Valeur : 0xC0AA0205 |
|
Il n’y a pas de 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 effectue une opération de longue durée, telle que 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 » peuvent résoudre ce problème.
Valeur : 0xC0AA0300 |
|
Le média n’est pas compatible ou de format physique inconnu.
Valeur : 0xC0AA0203 |
|
La structure du DVD n’est pas présente. Cela peut être dû à l’utilisation d’un lecteur/d’un moyen 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 pour 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 est incompatible 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é verrouillé exclusivement, ce qui a provoqué 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 |
|
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 |
Notes
Cette méthode définit la vitesse d’écriture et le type de contrôle de vitesse de rotation d’un enregistreur. Les valeurs demandées peuvent différer des valeurs définies dans l’enregistreur. Pour spécifier l’enregistreur, appelez la méthode IDiscFormat2Data::p ut_Recorder .
Si l’enregistreur prend en charge la vitesse d’écriture demandée, le périphérique à disque utilise la valeur demandée. Si l’enregistreur ne prend pas en charge la vitesse d’écriture demandée, l’enregistreur utilise une vitesse d’écriture qu’il prend en charge et qui est la plus proche de la valeur demandée. La propriété IDiscFormat2Data::get_CurrentWriteSpeed contient la valeur utilisée par l’enregistreur.
Pour récupérer la liste des vitesses d’écriture que l’enregistreur et le média actuel prennent en charge, appelez la méthode IDiscFormat2Data::get_SupportedWriteSpeeds .
Si vous demandez une vitesse angulaire constante (CAV) pour le type de contrôle de vitesse de rotation et que l’enregistreur ne prend pas en charge le CAV, le périphérique à disque utilise un autre type de contrôle de vitesse de rotation qu’il prend en charge. La propriété IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV indique la valeur utilisée par l’enregistreur.
Pour récupérer les valeurs demandées, appelez les méthodes IDiscFormat2Data::get_RequestedWriteSpeed et IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV .
Spécifications
| 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 |
Voir aussi
IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV
IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV