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
Mémoire tampon d'entrée
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) |