KSDEVICE_DESCRIPTOR 結構 (ks.h)

發行項
02/26/2024

KSDEVICE_DESCRIPTOR結構描述特定裝置的特性。

語法

typedef struct _KSDEVICE_DESCRIPTOR {
  const KSDEVICE_DISPATCH   *Dispatch;
  ULONG                     FilterDescriptorsCount;
  const KSFILTER_DESCRIPTOR const * * FilterDescriptors;
  ULONG                     Version;
  ULONG                     Flags;
  PVOID                     Alignment;
} KSDEVICE_DESCRIPTOR, *PKSDEVICE_DESCRIPTOR;

成員

Dispatch

此裝置之用戶端分派數據表的指標。此分派數據表包含 PNP 訊息的用戶端分派函式，例如 Add、 Start、 Stop、 Remove。除非用戶端想要接收分派數據表中所述之 PNP 訊息的回呼，否則用戶端不需要提供分派數據表。分派數據表的任何成員可以是 NULL ，表示用戶端不想要接收該特定訊息的通知。如需詳細資訊，請參閱 KSDEVICE_DISPATCH。

FilterDescriptorsCount

此成員包含將在 FilterDescriptors 成員中提供之此裝置的篩選描述元數目。零是這個成員的合法值;用戶端可以使用 KsCreateFilterFactory 函式動態建立篩選處理站，而不是以靜態方式在裝置描述元中加以描述。

FilterDescriptors

描述此裝置可建立之篩選條件描述元陣列的指標。如果 FilterDescriptorsCount 為零，此成員可能是 NULL。如需詳細資訊，請參閱 KSFILTER_DESCRIPTOR。

Version

ULONG 類型的值。這應該是下表中的一個值，如果撰寫0x100驅動程式，則設定為零。

值	Description
KSDEVICE_DESCRIPTOR_VERSION	表示支援 KSDEVICE_DISPATCH的AVStrMiniDeviceQueryInterface分派。
KSDEVICE_DESCRIPTOR_VERSION_2	表示支援 KSDEVICE_DESCRIPTOR的 Flags 成員。