Funzione EngQueryDeviceAttribute (winddi.h)

La funzione EngQueryDeviceAttribute consente al driver di eseguire query sul sistema su determinati attributi del dispositivo.

Sintassi

ENGAPI BOOL EngQueryDeviceAttribute(
  [in]  HDEV                 hdev,
  [in]  ENG_DEVICE_ATTRIBUTE devAttr,
  [in]  VOID                 *pvIn,
  [in]  ULONG                ulInSize,
  [out] VOID                 *pvOut,
  [out] ULONG                ulOutSize
);

Parametri

[in] hdev

Gestire il dispositivo. Questo parametro è l'handle GDI ricevuto dalla funzione DrvCompletePDEV del driver.

[in] devAttr

Specifica l'attributo per il quale GDI deve restituire informazioni. Questo parametro deve essere QDA_ACCELERATION_LEVEL, che esegue una query sulle accelerazioni del driver attualmente consentite da GDI.

[in] pvIn

Riservato per l'utilizzo nel sistema. Questo parametro è attualmente ignorato da GDI.

[in] ulInSize

Riservato per l'utilizzo nel sistema. Questo parametro è attualmente ignorato da GDI.

[out] pvOut

Puntatore a un buffer di byte ulOutSize in cui GDI scrive informazioni sull'attributo sottoposto a query. Quando devAttr è QDA_ACCELERATION_LEVEL, GDI scrive nel buffer un valore DWORD compreso tra 0 e 5 che indica il livello di accelerazione corrente. Per una descrizione dei livelli di accelerazione, vedere Display Driver Testing Tools (Visualizza strumenti di test driver per una descrizione dei livelli di accelerazione).

[out] ulOutSize

Specifica le dimensioni, in byte, del buffer a cui punta pvOut .

Valore restituito

EngQueryDeviceAttribute restituisceTRUE al successo; in caso contrario, restituisce FALSE.

Commenti

Il livello di accelerazione della scheda video può essere impostato dinamicamente tramite il programma Display in Pannello di controllo. EngQueryDeviceAttribute consente al driver di determinare il livello di accelerazione attualmente impostato.

Requisiti

Vedi anche

DrvNotify