共用方式為

BUS_INTERFACE_SWENUM結構 (swenum.h)

  • 發行項

BUS_INTERFACE_SWENUM結構描述需求載入總線列舉值物件的介面。

語法

typedef struct _BUS_INTERFACE_SWENUM {
  INTERFACE                  Interface;
  PFNREFERENCEDEVICEOBJECT   ReferenceDeviceObject;
  PFNDEREFERENCEDEVICEOBJECT DereferenceDeviceObject;
  PFNQUERYREFERENCESTRING    QueryReferenceString;
} BUS_INTERFACE_SWENUM, *PBUS_INTERFACE_SWENUM;

成員

Interface

指定導出的 介面。

ReferenceDeviceObject

驅動程式提供的 KsReferenceSoftwareBusObject 例程的指標。

DereferenceDeviceObject

驅動程式提供的 KsDereferenceSoftwareBusObject 例程的指標。

QueryReferenceString

驅動程式提供的 KsQuerySoftwareBusInterface 例程的指標。

備註

驅動程式會藉由建立和傳送指定IRP_MN_QUERY_INTERFACE次要函式程式碼的IRP_MJ_PNP要求，以取得 BUS_INTERFACE_SWENUM 介面。 若要這樣做，驅動程序應該：

  • 從分頁記憶體集區配置和零填滿BUS_INTERFACE_SWENUM結構。
  • 建立查詢介面要求的 IRP，並取得新 IRP 的下一個堆疊位置。
  • 在新的堆疊位置中，提供 Parameters.QueryInterface.Interface 成員中新BUS_INTERFACE_SWENUM結構的指標。
  • 設定完成例程，並將要求向下傳送至驅動程式堆疊。
  • 如果您的要求成功，系統會填入 Parameters.QueryInterface.Interface所指向的BUS_INTERFACE_SWENUM結構。

規格需求

需求 值
標頭 swenum.h (包含 Swenum.h)