IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)

Le code de contrôle IOCTL_CDROM_SEND_OPC_INFORMATION peut être utilisé dans les systèmes de fichiers et autres implémentations qui souhaitent effectuer la procédure Opc (Optimum Power Calibration) à l’avance, afin que la première écriture en streaming n’ait pas à attendre la fin de la procédure. Le lecteur optique effectue la procédure OPC pour déterminer la puissance optimale du laser pendant l’écriture. La procédure est nécessaire pour garantir la qualité, mais elle use le média et ne doit pas être effectuée trop souvent.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec IOCTL_CDROM_SEND_OPC_INFORMATION comme paramètre dwIoControlCode .

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

CDROM_SIMPLE_OPC_INFO

Longueur de la mémoire tampon d’entrée

Longueur d’un CDROM_SIMPLE_OPC_INFO.

Mémoire tampon de sortie

Aucun.

Longueur de la mémoire tampon de sortie

Aucun.

Bloc d’état

Le champ Informations est défini sur le nombre d’octets retournés.

En raison de status propagation de code à partir d’autres API, le champ État peut être défini sur (mais n’est pas limité à) les éléments suivants :

STATUS_INFO_LENGTH_MISMATCH

La longueur de la mémoire tampon d’entrée est inférieure à celle requise.

STATUS_INVALID_PARAMETER

Le type de requête n’est pas SimpleOpcInfo.

STATUS_SUCCESS

La demande s’est terminée avec succès.

Remarques

Le IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL est un wrapper sur la commande SEND OPC INFORMATION de la spécification MMC. Les champs Exclude0 et Exclude1 mappent directement aux champs SEND OPC INFORMATION portant les mêmes noms.

En cas d’échec, ce IOCTL retourne des erreurs standard, telles que STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT, STATUS_IO_DEVICE_ERROR.

Configuration requise

Condition requise	Valeur
En-tête	ntddcdrm.h (inclure Winioctl.h)

Voir aussi

CDROM_SIMPLE_OPC_INFO

DeviceIoControl

IOCTL_CDROM_SEND_OPC_INFORMATION