DEV_QUERY_RESULT_ACTION_DATA結構 （devquerydef.h）

提供 PDEV_QUERY_RESULT_CALLBACK 回呼函式的資訊。

語法

typedef struct _DEV_QUERY_RESULT_ACTION_DATA {
  DEV_QUERY_RESULT_ACTION          Action;
  union _DEV_QUERY_RESULT_UPDATE_PAYLOAD {
    DEV_QUERY_STATE State;
    DEV_OBJECT      DeviceObject;
  } Data;
} DEV_QUERY_RESULT_ACTION_DATA, *PDEV_QUERY_RESULT_ACTION_DATA;

成員

Action

來自 DEV_QUERY_RESULT_ACTION 列舉的值，指定要執行的動作類型。

Data

_DEV_QUERY_RESULT_UPDATE_PAYLOAD 等位的值。

Data.State

指定查詢目前狀態之 DEV_QUERY_STATE 列舉的值。 只有當 Action 等於 DevQueryResultStateChange時，這個成員才有效。

Data.DeviceObject

與查詢結果相關聯的 DEV_OBJECT 結構。 只有當 Action 等於 DevQueryResultAdd、DevQueryResultUpdate或 DevQueryResultRemove時，這個成員才有效。 下表會根據 [Action] 字段的值，指定應該如何解譯 DevObject 字段。

動作值	DeviceObject 的解譯
DevQueryResultAdd	DeviceObject 代表要加入至查詢結果集的新對象，因為它符合查詢篩選參數的準則。 DeviceObject 會包含查詢要求之所有屬性的屬性清單。
DevQueryResultUpdate	DeviceObject 代表查詢結果集中已有已變更要求屬性的物件。 DeviceObject 中的屬性清單 會提供已變更的屬性。
DevQueryResultRemove	DeviceObject 代表從查詢結果集中移除的對象，因為該物件不再符合查詢篩選參數的準則。

_DEV_QUERY_RESULT_UPDATE_PAYLOAD

聯集，包含與動作相關聯的狀態或物件。

要求

要求	價值
標頭	devquerydef.h