Função EngQueryDeviceAttribute (winddi.h)
A função EngQueryDeviceAttribute permite que o driver consulte o sistema sobre atributos específicos do dispositivo.
Sintaxe
ENGAPI BOOL EngQueryDeviceAttribute(
[in] HDEV hdev,
[in] ENG_DEVICE_ATTRIBUTE devAttr,
[in] VOID *pvIn,
[in] ULONG ulInSize,
[out] VOID *pvOut,
[out] ULONG ulOutSize
);
Parâmetros
[in] hdev
Manipule para o dispositivo. Esse parâmetro é o identificador GDI recebido pela função DrvCompletePDEV do driver.
[in] devAttr
Especifica o atributo para o qual o GDI deve retornar informações. Esse parâmetro deve ser QDA_ACCELERATION_LEVEL, que consulta as acelerações de driver que o GDI permite atualmente.
[in] pvIn
Reservado para uso do sistema. No momento, esse parâmetro é ignorado pelo GDI.
[in] ulInSize
Reservado para uso do sistema. No momento, esse parâmetro é ignorado pelo GDI.
[out] pvOut
Ponteiro para um buffer de bytes ulOutSize no qual o GDI grava informações sobre o atributo que está sendo consultado. Quando devAttr é QDA_ACCELERATION_LEVEL, o GDI grava no buffer um valor DWORD de 0 a 5 que indica o nível de aceleração atual. Consulte Exibir Ferramentas de Teste de Driver para obter uma descrição dos níveis de aceleração.
[out] ulOutSize
Especifica o tamanho, em bytes, do buffer para o qual o pvOut aponta.
Retornar valor
EngQueryDeviceAttribute retorna TRUE após o sucesso; caso contrário, retornará FALSE.
Comentários
O nível de aceleração do cartão de vídeo pode ser definido dinamicamente por meio do programa Display em Painel de Controle. EngQueryDeviceAttribute permite que o driver determine o nível de aceleração definido no momento.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |