IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
Der IOCTL_CDROM_SEND_OPC_INFORMATION Steuercode kann in Dateisystemen und anderen Implementierungen verwendet werden, die die OPC-Prozedur (Optimum Power Calibration) im Voraus ausführen möchten, sodass der erste Streamingschreibvorgang nicht auf den Abschluss der Prozedur warten muss. Das optische Laufwerk führt das OPC-Verfahren durch, um die optimale Leistung des Lasers während des Schreibvorgangs zu bestimmen. Das Verfahren ist notwendig, um die Qualität sicherzustellen, aber es verschleißt die Medien und sollte nicht zu oft durchgeführt werden.
Um diesen Vorgang auszuführen, rufen Sie die DeviceIoControl-Funktion mit IOCTL_CDROM_SEND_OPC_INFORMATION als dwIoControlCode-Parameter auf.
Hauptcode
Eingabepuffer
Länge des Eingabepuffers
Länge eines CDROM_SIMPLE_OPC_INFO.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
Das Feld Information ist auf die Anzahl der zurückgegebenen Bytes festgelegt.
Aufgrund status Codeweitergabe von anderen APIs kann das Feld Status auf Folgendes festgelegt werden (ist jedoch nicht beschränkt auf):
STATUS_INFO_LENGTH_MISMATCH
Die Länge des Eingabepuffers ist kleiner als erforderlich.
STATUS_INVALID_PARAMETER
Der Anforderungstyp ist nicht SimpleOpcInfo.
STATUS_SUCCESS
Die Anforderung wurde erfolgreich abgeschlossen.
Hinweise
Die IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL ist ein Wrapper über den Befehl SEND OPC INFORMATION der MMC-Spezifikation. Die Felder Exclude0 und Exclude1 werden direkt den Feldern SEND OPC INFORMATION mit den gleichen Namen zugeordnet.
Bei Fehlern gibt diese IOCTL Standardfehler zurück, z. B. STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT, STATUS_IO_DEVICE_ERROR.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddcdrm.h (winioctl.h einschließen) |