IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)
Der IOCTL_CDROM_SEND_OPC_INFORMATION Steuerungscode kann in Dateisystemen und anderen Implementierungen verwendet werden, die das Optimum Power Calibration (OPC)-Verfahren im Voraus ausführen möchten, sodass der erste Streaming-Schreibvorgang nicht warten muss, bis die Prozedur abgeschlossen ist. Das optische Laufwerk führt das OPC-Verfahren aus, um die optimale Leistung des Lasers während des Schreibvorgangs zu bestimmen. Das Verfahren ist notwendig, um qualität zu gewährleisten, aber es trägt die Medien ab und sollte nicht zu oft durchgeführt werden.
Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl--Funktion mit IOCTL_CDROM_SEND_OPC_INFORMATION als dwIoControlCode--Parameter auf.
Hauptcode
Eingabepuffer
Eingabepufferlänge
Länge eines CDROM_SIMPLE_OPC_INFO.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Das Feld Information wird auf die Anzahl der zurückgegebenen Bytes festgelegt.
Aufgrund der Statuscodeverteilung von anderen APIs kann das feld Status auf Folgendes festgelegt werden (aber 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.
Bemerkungen
Die IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL ist ein Wrapper über den BEFEHL SEND OPC INFORMATION der MMC-Spezifikation. Die felder Exclude0 and Exclude1 fields directly map to the SEND OPC INFORMATION fields with the same names.
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 (include Winioctl.h) |