Lire en anglais

Partager via


Méthode IDiscRecorder2Ex::GetFeaturePage (imapi2.h)

Récupère la page de fonctionnalité spécifiée à partir de l’appareil.

Syntaxe

HRESULT GetFeaturePage(
  [in]  IMAPI_FEATURE_PAGE_TYPE   requestedFeature,
  [in]  BOOLEAN                   currentFeatureOnly,
  [out] BYTE                      **featureData,
  [out] ULONG_IMAPI2_FEATURE_PAGE *byteSize
);

Paramètres

[in] requestedFeature

Page de fonctionnalité à récupérer. Pour connaître les valeurs possibles, consultez le IMAPI_FEATURE_PAGE_TYPE type d’énumération .

[in] currentFeatureOnly

Définissez sur True pour récupérer la page de fonctionnalités uniquement lorsqu’il s’agit de la page de fonctionnalité active. Sinon, false pour récupérer la page de fonctionnalité, qu’il s’agisse de la page de fonctionnalité actuelle.

[out] featureData

Mémoire tampon de données qui contient la page des fonctionnalités. Pour plus d’informations sur le contenu de la mémoire tampon de données, consultez la commande GET CONFIGURATION dans la dernière révision de la spécification MMC sur ftp://ftp.t10.org/t10/drafts/mmc5.

Cette méthode supprime les informations d’en-tête et d’autres données non liées aux fonctionnalités avant de remplir et d’envoyer cette mémoire tampon.

Lorsque vous avez terminé, appelez la fonction CoTaskMemFree pour libérer la mémoire.

[out] byteSize

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

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_POINTER
Le pointeur n’est pas valide.

Valeur : 0x80004003

E_FAIL
Défaillance non spécifiée.

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é demandée n’est pas prise en charge par l’appareil.

Valeur : 0xC0AA020A

E_OUTOFMEMORY
Impossible d’allouer la mémoire requise.

Valeur : 0x8007000E

E_IMAPI_RECORDER_FEATURE_IS_NOT_CURRENT
La page de fonctionnalité 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 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

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 train de se préparer. Veuillez réessayer la demande ultérieurement.

Valeur : 0xC0AA0205

E_IMAPI_RECORDER_MEDIA_NO_MEDIA
Il n’y a aucun 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 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

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 » peut 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 DVD n’est pas présente. Cela peut être dû à l’utilisation d’un lecteur/d’un support 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 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é en écriture.

Valeur : 0xC0AA0209

E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
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

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é exclusivement verrouillé, ce qui a entraîné 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::GetSupportedFeaturePages

IMAPI_FEATURE_PAGE_TYPE