Cabeçalho ntddcdrm.h

Esse cabeçalho é usado pelo armazenamento. Para obter mais informações, consulte:

• Armazenamento

ntddcdrm.h contém as seguintes interfaces de programação:

IOCTLs

IOCTL_CDROM_CHECK_VERIFY O IOCTL_CDROM_CHECK_VERIFY IOCTL é substituído por IOCTL_STORAGE_CHECK_VERIFY no Microsoft Windows 2000 e sistemas operacionais posteriores.
IOCTL_CDROM_ENABLE_STREAMING Habilita ou desabilita o modo de streaming CDROM por identificador para solicitações brutas de leitura e gravação.
IOCTL_CDROM_EXCLUSIVE_ACCESS A solicitação IOCTL_CDROM_EXCLUSIVE_ACCESS instrui o driver de classe CD-ROM a:Relatar o estado de acesso de um dispositivo CD-ROM.
IOCTL_CDROM_FIND_NEW_DEVICES O IOCTL_CDROM_FIND_NEW_DEVICES IOCTL é substituído por IOCTL_STORAGE_FIND_NEW_DEVICES no Microsoft Windows 2000 e sistemas operacionais posteriores.
IOCTL_CDROM_GET_CONFIGURATION Solicita informações de recurso e perfil de um dispositivo CD-ROM.
IOCTL_CDROM_GET_CONTROL Essa solicitação IOCTL está obsoleta. Não use. Determina o modo de reprodução de áudio atual.
IOCTL_CDROM_GET_DRIVE_GEOMETRY Retorna informações sobre a geometria do CD-ROM (tipo de mídia, número de cilindros, faixas por cilindro, setores por faixa e bytes por setor).
IOCTL_CDROM_GET_DRIVE_GEOMETRY_EX Retorna informações sobre a geometria de um CD-ROM (tipo de mídia, número de cilindros, faixas por cilindro, setores por faixa e bytes por setor). A solicitação IOCTL_CDROM_GET_DRIVE_GEOMETRY_EX difere da solicitação de IOCTL_CDROM_GET_DRIVE_GEOMETRY mais antiga.
IOCTL_CDROM_GET_INQUIRY_DATA Retorna os dados de consulta SCSI para o dispositivo CD-ROM. Esse IOCTL pode ser usado quando um dispositivo foi bloqueado exclusivamente com IOCTL_CDROM_EXCLUSIVE_ACCESS.
IOCTL_CDROM_GET_LAST_SESSION Consulta o dispositivo para obter o primeiro número de sessão completo, o último número de sessão completo e o último endereço inicial da sessão completa.
IOCTL_CDROM_GET_PERFORMANCE Recupera as velocidades com suporte do dispositivo. O IOCTL_CDROM_GET_PERFORMANCE solicitação de controle de E/S é um wrapper sobre o comando do MMC, GET PERFORMANCE.
IOCTL_CDROM_GET_VOLUME Determina o volume atual para cada uma das portas de áudio do dispositivo. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_LOAD_MEDIA Desenha uma bandeja CDROM saliência de volta para a unidade.
IOCTL_CDROM_PAUSE_AUDIO Suspende a reprodução de áudio. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_PLAY_AUDIO_MSF Reproduz o intervalo especificado da mídia. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_RAW_READ Lê dados do CD-ROM no modo bruto.
IOCTL_CDROM_READ_Q_CHANNEL Retorna a posição atual, o catálogo de mídia ou os dados de acompanhamento do ISRC. A leitura da posição atual está obsoleta, começando com o Windows Vista.
IOCTL_CDROM_READ_TOC Retorna o sumário da mídia. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_READ_TOC_EX Consulta o dispositivo de destino para o sumário (TOC), a PMA (área de memória do programa) e o tempo absoluto em pregroove (ATIP).
IOCTL_CDROM_RESUME_AUDIO Retoma uma operação de áudio suspensa. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_SEEK_AUDIO_MSF Move as cabeças para o MSF especificado na mídia. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_SEND_OPC_INFORMATION O código de controle IOCTL_CDROM_SEND_OPC_INFORMATION pode ser usado em sistemas de arquivos e em 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.
IOCTL_CDROM_SET_SPEED Define a velocidade do eixo da unidade de CD-ROM.
IOCTL_CDROM_SET_VOLUME Redefine o volume para as portas de áudio do dispositivo. Obsoleto, começando com o Windows Vista.
IOCTL_CDROM_STOP_AUDIO Encerra a reprodução de áudio. Obsoleto, começando com o Windows Vista.

Estruturas

CDROM_AUDIO_CONTROL A estrutura CDROM_AUDIO_CONTROL é usada em conjunto com a solicitação IOCTL_CDROM_GET_CONTROL para relatar o modo de reprodução de áudio.
CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR A estrutura CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR indica que os dados resultantes da solicitação de controle de E/S IOCTL_CDROM_GET_PERFORMANCE são para condições de exceção.
CDROM_EXCLUSIVE_ACCESS A estrutura CDROM_EXCLUSIVE_ACCESS é usada com a solicitação IOCTL_CDROM_EXCLUSIVE_ACCESS para consultar o estado de acesso de um dispositivo CD-ROM ou para bloquear ou desbloquear o dispositivo para acesso exclusivo.
CDROM_EXCLUSIVE_LOCK A estrutura CDROM_EXCLUSIVE_LOCK é usada com a solicitação IOCTL_CDROM_EXCLUSIVE_ACCESS para bloquear um dispositivo CD-ROM para acesso exclusivo.
CDROM_EXCLUSIVE_LOCK_STATE A estrutura CDROM_EXCLUSIVE_LOCK_STATE é usada pelo driver da classe CD-ROM para relatar o estado de acesso exclusivo de um dispositivo CD-ROM.
CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR A estrutura CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR fornece ao host uma aproximação do desempenho da unidade lógica.
CDROM_PERFORMANCE_HEADER A estrutura CDROM_PERFORMANCE_HEADER é usada pelo IOCTL_CDROM_GET_PERFORMANCE IOCTL para retornar dados. Quando o tipo de solicitação é CdromPerformanceRequest, o IOCTL retorna esse cabeçalho seguido por descritores opcionais.
CDROM_PERFORMANCE_REQUEST A estrutura CDROM_PERFORMANCE_REQUEST é usada como um parâmetro de entrada para a solicitação de controle de E/S do IOCTL_CDROM_GET_PERFORMANCE e descreve os dados de desempenho solicitados.
CDROM_PLAY_AUDIO_MSF Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_PLAY_AUDIO_MSF usam essa estrutura para reproduzir um CD de áudio.
CDROM_READ_TOC_EX Quando os drivers consultam um dispositivo CD-ROM de destino com IOCTL_CDROM_READ_TOC_EX eles devem definir a consulta com essa estrutura.
CDROM_SEEK_AUDIO_MSF A estrutura CDROM_SEEK_AUDIO_MSF contém o minuto, o segundo e o quadro que o dispositivo deve buscar após o recebimento de um IRP de controle de dispositivo com um código de controle de IOCTL_CDROM_SEEK_AUDIO_MSF.
CDROM_SET_SPEED A estrutura CDROM_SET_SPEED é usada com a solicitação IOCTL_CDROM_SET_SPEED para definir a velocidade do eixo de uma unidade cd-ROM durante transferências de dados nas quais nenhuma perda de dados é permitida.
CDROM_SET_STREAMING A estrutura CDROM_SET_SPEED é usada com a solicitação IOCTL_CDROM_SET_SPEED para definir a velocidade do eixo de uma unidade CD-ROM durante transferências isócronas que permitem alguma perda de dados.
CDROM_SIMPLE_OPC_INFO A estrutura CDROM_SIMPLE_OPC_INFO é a única entrada para o código de controle de E/S IOCTL_CDROM_SEND_OPC_INFORMATION.
CDROM_STREAMING_CONTROL A estrutura CDROM_STREAMING_CONTROL é usada como um parâmetro de entrada para o IOCTL_CDROM_ENABLE_STREAMING IOCTL.
CDROM_SUB_Q_DATA_FORMAT A estrutura CDROM_SUB_Q_DATA_FORMAT é usada com IRPs de controle de dispositivo do tipo IOCTL_CDROM_READ_Q_CHANNEL.
CDROM_TOC Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_TOC retornam seus dados de saída nessa estrutura seguidos por uma série de estruturas de TRACK_DATA.
CDROM_TOC_ATIP_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_ATIP retornam seus dados de saída nessa estrutura de cabeçalho seguidos por uma série de descritores do tipo CDROM_TOC_ATIP_DATA_BLOCK.
CDROM_TOC_ATIP_DATA_BLOCK Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_ATIP retornam seus dados de saída em uma estrutura de cabeçalho do tipo CDROM_TOC_ATIP_DATA seguida por uma série de descritores de bloco de dados da ATIP definidos por CDROM_TOC_ATIP_DATA_BLOCK.
CDROM_TOC_CD_TEXT_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_CDTEXT retornam seus dados de saída nessa estrutura seguidos por uma série de descritores do tipo CDROM_TOC_CD_TEXT_DATA_BLOCK.
CDROM_TOC_CD_TEXT_DATA_BLOCK Essa estrutura contém dados do descritor de texto cd usados em conjunto com os dados na estrutura CDROM_TOC_CD_TEXT_DATA.
CDROM_TOC_FULL_TOC_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_FULL_TOC retornam seus dados de saída nessa estrutura opcionalmente seguidos por uma série de descritores do tipo CDROM_TOC_FULL_TOC_DATA_BLOCK.
CDROM_TOC_FULL_TOC_DATA_BLOCK A estrutura CDROM_TOC_FULL_TOC_DATA_BLOCK contém dados de descritor de faixa usados em conjunto com os dados da estrutura CDROM_TOC_FULL_TOC_DATA.
CDROM_TOC_PMA_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_PMA retornam seus dados de saída nessa estrutura opcionalmente seguidos por uma série de descritores do tipo CDROM_TOC_FULL_TOC_DATA_BLOCK.
CDROM_TOC_SESSION_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_TOC_EX e um formato de CDROM_READ_TOC_EX_FORMAT_SESSION retornam seus dados de saída nessa estrutura seguidos por uma série de estruturas de TRACK_DATA.
CDROM_WRITE_SPEED_DESCRIPTOR A estrutura CDROM_WRITE_SPEED_DESCRIPTOR é retornada para o IOCTL_CDROM_GET_PERFORMANCE IOCTL quando o tipo de solicitação é CdromWriteSpeedRequest.
CDROM_WRITE_SPEED_REQUEST A estrutura CDROM_WRITE_SPEED_REQUEST é usada como um parâmetro de entrada para o IOCTL IOCTL_CDROM_GET_PERFORMANCE e para solicitar descritores de velocidade de gravação.
RAW_READ_INFO A estrutura RAW_READ_INFO é usada em conjunto com a solicitação IOCTL_CDROM_RAW_READ para ler dados de um CD-ROM no modo bruto.
SUB_Q_CHANNEL_DATA Os IRPs de controle de dispositivo com um código de controle de IOCTL_CDROM_READ_Q_CHANNEL retornam seus dados de saída nessa união.
SUB_Q_CURRENT_POSITION A estrutura SUB_Q_CURRENT_POSITION contém informações de posição e é usada em conjunto com SUB_Q_CHANNEL_DATA.
SUB_Q_HEADER A estrutura SUB_Q_HEADER contém informações de status de áudio e o comprimento dos dados de subcanal Q que estão sendo retornados. Essa estrutura é usada em conjunto com SUB_Q_CHANNEL_DATA.
SUB_Q_MEDIA_CATALOG_NUMBER A estrutura SUB_Q_MEDIA_CATALOG_NUMBER contém informações de posição e é usada em conjunto com a estrutura SUB_Q_CHANNEL_DATA.
SUB_Q_TRACK_ISRC O SUB_Q_TRACK_ISC contém informações de posição e é usado em conjunto com a estrutura SUB_Q_CHANNEL_DATA.
TRACK_DATA O descritor de faixa é usado em conjunto com CDROM_TOC e CDROM_TOC_SESSION_DATA.
VOLUME_CONTROL A estrutura VOLUME_CONTROL é usada em conjunto com a solicitação IOCTL_CDROM_GET_VOLUME para recuperar valores de volume para até quatro portas de áudio.

Enumerações

CDROM_OPC_INFO_TYPE A enumeração CDROM_OPC_INFO_TYPE é um membro da estrutura CDROM_SIMPLE_OPC_INFO. Ele define a solicitação OPC (Otimização de Calibragem de Energia) usada como entrada para a solicitação de controle de E/S IOCTL_CDROM_SEND_OPC_INFORMATION.
CDROM_PERFORMANCE_EXCEPTION_TYPE A enumeração CDROM_PERFORMANCE_EXCEPTION_TYPE define as condições excepcionais para dados de desempenho.
CDROM_PERFORMANCE_REQUEST_TYPE A enumeração CDROM_PERFORMANCE_REQUEST_TYPE define os tipos de solicitações de dados de desempenho. Ele é um membro da estrutura CDROM_PERFORMANCE_REQUEST, que é usada como um parâmetro de entrada para a solicitação de controle de E/S IOCTL_CDROM_GET_PERFORMANCE.
CDROM_PERFORMANCE_TOLERANCE_TYPE A enumeração CDROM_PERFORMANCE_TOLERANCE_TYPE define as tolerâncias permitidas para dados de desempenho. Ele é um membro da estrutura CDROM_PERFORMANCE_REQUEST, que é usada como um parâmetro de entrada para a solicitação de controle de E/S IOCTL_CDROM_GET_PERFORMANCE.
CDROM_PERFORMANCE_TYPE A enumeração CDROM_PERFORMANCE_TYPE define as solicitações de dados de desempenho de leitura e gravação. Ele é um membro da estrutura CDROM_PERFORMANCE_REQUEST, que é usada como um parâmetro de entrada para a solicitação de controle de E/S IOCTL_CDROM_GET_PERFORMANCE.
CDROM_SPEED_REQUEST A enumeração CDROM_SPEED_REQUEST indica qual comando o driver de classe CD-ROM usará para definir a velocidade do eixo de uma unidade CD-ROM.
EXCLUSIVE_ACCESS_REQUEST_TYPE A enumeração EXCLUSIVE_ACCESS_REQUEST_TYPE é usada para relatar o estado de acesso exclusivo de um dispositivo CD-ROM.
STREAMING_CONTROL_REQUEST_TYPE A enumeração STREAMING_CONTROL_REQUEST_TYPE define os modos de streaming CDROM.
TRACK_MODE_TYPE O tipo de enumeração TRACK_MODE_TYPE é usado em conjunto com a solicitação IOCTL_CDROM_RAW_READ e a estrutura RAW_READ_INFO para ler dados de um CD-ROM no modo bruto.
WRITE_ROTATION A enumeração WRITE_ROTATION especifica se uma unidade CD-ROM usa rotação de CLV (velocidade linear constante) ou rotação cav (velocidade angular constante) quando grava em um CD.