Compartilhar via


IOCTL_LAMP_GET_CAPABILITIES_WHITE IOCTL (lamp.h)

O código de controle IOCTL_LAMP_GET_CAPABILITIES_WHITE consulta os recursos da lâmpada quando o dispositivo está configurado para emitir luz branca.

#define IOCTL_LAMP_GET_CAPABILITIES_WHITE \
    CTL_CODE(IOCTL_LAMP_BASE, 0x0000, METHOD_BUFFERED, FILE_ANY_ACCESS)

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Irp->AssociatedIrp.SystemBuffer aponta para um buffer do tipo LAMP_CAPABILITIES_WHITE.

Comprimento do buffer de entrada

Comprimento do buffer.

Buffer de saída

Irp->AssociatedIrp.SystemBuffer é preenchido com todos os recursos compatíveis com o hardware da lâmpada.

Comprimento do buffer de saída

IO_STACK_LOCATION.Parameters.DeviceIoControl.OutputBufferLength é o comprimento do buffer (em bytes) passado no campo Irp->AssociatedIrp.SystemBuffer.

Bloco de status

O driver define Irp->IoStatus.Status como STATUS_SUCCESS ou o status de erro apropriado. Ele definirá Irp->IoStatus.Information para o número de bytes necessários para manter o buffer.

Observações

Por requisito, uma lâmpada cujo driver dá suporte à interface GUID_DEVINTERFACE_LAMP é necessária para dar suporte à emissão de luz branca.

O conteúdo deste IOCTL é uma estrutura LAMP_CAPABILITIES_WHITE.

O campo isLightIntensityAdjustable indica se o nível de luminância pode ser programado. Se esse campo for avaliado como FALSE, isso significa que o dispositivo subjacente só dá suporte ao botão de ativação/desativação e a intensidade da luz não pode ser ajustada.

Requisitos

Requisito Valor
cabeçalho lamp.h