IDiscRecorder2Ex::SetModePage, méthode (imapi2.h)

Article
09/29/2022
3 minutes de lecture

Définit les données de page en mode pour l’appareil.

Syntaxe

HRESULT SetModePage(
  [in] IMAPI_MODE_PAGE_REQUEST_TYPE requestType,
  [in] BYTE                         *data,
  [in] ULONG_IMAPI2_MODE_PAGE       byteSize
);

Paramètres

[in] requestType

Type de données de page en mode à envoyer. Pour obtenir les valeurs possibles, consultez le type d’énumération IMAPI_MODE_PAGE_REQUEST_TYPE .

[in] data

Mémoire tampon de données qui contient les données de page en mode à envoyer au média. N’incluez pas d’en-tête ; cette méthode génère et prépend un en-tête aux données de page en mode.

Pour plus d’informations sur la spécification des champs des données de page en mode, consultez la commande MODE SELECT (10) dans la dernière révision de la spécification MMC à ftp://ftp.t10.org/t10/drafts/mmc5.

[in] byteSize

Taille, en octets, de la mémoire tampon de données.

Valeur retournée

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

Code de retour	Description
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
E_FAIL	Échec non spécifié. Valeur : 0x80004005
E_IMAPI_RECORDER_GET_CONFIGURATION_NOT_SUPPORTED	Le lecteur ne prend pas en charge la commande GET CONFIGURATION. Valeur : 0xC0AA020C
E_IMAPI_RECORDER_NO_SUCH_FEATURE	La page de fonctionnalités demandée n’est pas prise en charge par l’appareil. Valeur : 0xC0AA020A
E_OUTOFMEMORY	Échec de l’allocation de la mémoire requise. Valeur : 0x8007000E
E_IMAPI_RECORDER_FEATURE_IS_NOT_CURRENT	La page de fonctionnalités demandée est prise en charge, mais n’est pas marquée comme actuelle. Valeur : 0xC0AA020B
E_IMAPI_RECORDER_COMMAND_TIMEOUT	L’appareil n’a pas pu accepter la commande au cours de la période 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
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. Réessayez 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 actuellement mis en forme. Attendez que le format soit terminé avant de tenter 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 suffisamment de données pour continuer à écrire. 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 « tampon sous-exécution libre » peut résoudre ce problème. Valeur : 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Le média n’est pas compatible ou d’un format physique inconnu. Valeur : 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	La structure DVD n’est pas présente. Cela peut être dû à un lecteur/moyen incompatible utilisé. 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ésente. Valeur : 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	Le lecteur a signalé que la combinaison de paramètres fournis dans la page de mode d’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é. 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 support de vitesse supérieur ou inférieur à 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 l’appareil spécifié n’est plus disponible. Valeur : 55
E_IMAPI_RECORDER_LOCKED	L’appareil associé à cet enregistreur au cours de la dernière opération a été verrouillé exclusivement, ce qui entraîne l’échec de cette opération. Valeur : 0xC0AA0210

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

Voir aussi

IDiscRecorder2Ex

IDiscRecorder2Ex::GetModePage

IDiscRecorder2Ex::GetSupportedModePages

IMAPI_MODE_PAGE_REQUEST_TYPE

IMAPI_MODE_PAGE_TYPE