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 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 usa 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
Buffer de entrada
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 de é definido como o número de bytes retornados.
Devido à propagação de código de status de outras APIs, o campo Status pode ser definido como (mas não está limitado 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.
Observações
O IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL é um wrapper sobre o comando SEND OPC INFORMATION da especificação do MMC. Os campos Excluir0 e Excluir1 são mapeados diretamente para os campos SEND OPC INFORMATION 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) |