IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL (ntddcdrm.h)

O código de controle IOCTL_CDROM_SEND_OPC_INFORMATION pode ser usado em sistemas de arquivos e outras implementações que desejam executar o procedimento OPC (Otimização de Calibragem de Energia) com antecedência, para que a primeira gravação de streaming não precise aguardar a conclusão do procedimento. A unidade óptica executa o procedimento OPC para determinar o poder ideal do laser durante a gravação. O procedimento é necessário para garantir a qualidade, mas desgasta a mídia e não deve ser executado com muita frequência.

Para executar essa operação, chame a função DeviceIoControl com IOCTL_CDROM_SEND_OPC_INFORMATION como o parâmetro dwIoControlCode .

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

CDROM_SIMPLE_OPC_INFO

Comprimento do buffer de entrada

Comprimento de um CDROM_SIMPLE_OPC_INFO.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

O campo Informações é definido como o número de bytes retornados.

Devido a status propagação de código de outras APIs, o campo Status pode ser definido como (mas não se limita a) o seguinte:

STATUS_INFO_LENGTH_MISMATCH

O comprimento do buffer de entrada é menor do que o necessário.

STATUS_INVALID_PARAMETER

O tipo de solicitação não é SimpleOpcInfo.

STATUS_SUCCESS

A solicitação foi concluída com êxito.

Comentários

O IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL é um wrapper sobre o comando SEND OPC INFORMATION da especificação do MMC. Os campos Exclude0 e Exclude1 são mapeados diretamente para os campos ENVIAR INFORMAÇÕES OPC com os mesmos nomes.

Em falhas, esse IOCTL retorna erros padrão, como STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT STATUS_IO_DEVICE_ERROR.

Requisitos

Requisito	Valor
Cabeçalho	ntddcdrm.h (inclua Winioctl.h)

Confira também

CDROM_SIMPLE_OPC_INFO

DeviceIoControl

IOCTL_CDROM_SEND_OPC_INFORMATION