IDiscFormat2RawCD::SetWriteSpeed, méthode (imapi2.h)

Article
08/24/2023

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
E_IMAPI_RECORDER_REQUIRED	La demande nécessite qu’un enregistreur de disque actif soit sélectionné. Valeur : 0xC0AA0003
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides. Valeur : 0x80070057
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
E_FAIL	Défaillance non spécifiée. Valeur : 0x80004005
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	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
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	L’appareil a signalé des données inattendues ou non valides pour une commande. Valeur : 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	Le média est inséré à l’envers. Valeur : 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	Le lecteur a signalé qu’il est en cours de préparation. Veuillez réessayer la demande ultérieurement. Valeur : 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Il n’y a pas de média dans l’appareil. Valeur : 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	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
E_IMAPI_RECORDER_MEDIA_BUSY	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
E_IMAPI_LOSS_OF_STREAMING	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
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Le média n’est pas compatible ou de format physique inconnu. Valeur : 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	La structure du DVD n’est pas présente. Cela peut être dû à l’utilisation d’un lecteur/d’un moyen incompatible. Valeur : 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	L’appareil a signalé que la page du mode demandé (et le type) n’est pas présent. Valeur : 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	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
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	Le lecteur a signalé que le média est protégé en écriture. Valeur : 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	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
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	Le handle spécifié n’est pas valide. Valeur : 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	La ressource réseau ou le périphérique spécifié n’est plus disponible. Valeur : 55
E_IMAPI_RECORDER_LOCKED	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
E_IMAPI_DF2RAW_MEDIA_IS_NOT_SUPPORTED	Seul le support CD-R/RW vide est pris en charge. Valeur : 0xC0AA0606
E_IMAPI_DF2RAW_MEDIA_IS_NOT_BLANK	Seul le support CD-R/RW vide est pris en charge. Valeur : 0xC0AA0607
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID	Le nom du client n’est pas valide. Valeur : 0xC0AA0604
S_IMAPI_ROTATIONADJUSTED	Le type de rotation demandé n’était pas pris en charge par le lecteur et le type de rotation a été ajusté. Valeur : 0x00AA0005
S_IMAPI_SPEEDADJUSTED	La vitesse d’écriture demandée n’était pas prise en charge par le lecteur et la vitesse a été ajustée. Valeur : 0x00AA0004
S_IMAPI_BOTHADJUSTED	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 IDiscFormat2RawCD::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é IDiscFormat2RawCD::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 IDiscFormat2RawCD::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é IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV indique la valeur utilisée par l’enregistreur.

Pour récupérer les valeurs demandées, appelez les méthodes IDiscFormat2RawCD::get_RequestedWriteSpeed et IDiscFormat2RawCD::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

IDiscFormat2RawCD

IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV

IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV

IDiscFormat2RawCD::get_SupportedWriteSpeedDescriptors

IDiscFormat2RawCD::get_SupportedWriteSpeeds

Partager via