初始化 BDA Minidriver

發行項
06/15/2023

BDA 迷你驅動程式的初始化方式類似于其他 AVStream 迷你驅動程式。 BDA 迷你驅動程式的 DriverEntry 函式會呼叫 AVStream KsInitializeDriver 函式，以初始化 BDA 迷你驅動程式的驅動程式物件。在此呼叫中，BDA 迷你驅動程式會將指標傳遞至指定裝置特性 的KSDEVICE_DESCRIPTOR 結構，其中包括：

包含 BDA 裝置分派資料表 之KSDEVICE_DISPATCH 結構的指標。 BDA 迷你驅動程式至少應該提供建立和啟動裝置的常式，並在KSDEVICE_DISPATCH結構的 Add 和 Start 成員中分別指定這些常式。 BDA 迷你驅動程式的 create 常式應該配置裝置類別的記憶體，並將 BDA 裝置 KSDEVICE 結構的指標參考到此裝置類別。 BDA 迷你驅動程式的開始常式應該從登錄取得裝置的相關資訊、設定裝置的相關資訊，然後使用 BDA 支援程式庫註冊一組靜態範本結構。如需詳細資訊，請參閱啟動 BDA Minidriver 。
此裝置所支援之個別篩選類型的 KSFILTER_DESCRIPTOR 結構陣列。此結構類型描述指定篩選處理站所建立之篩選的特性。如果您建立 BDA 迷你驅動程式，使其不使用 BDA 支援程式庫 (Bdasup.lib) 來處理 BDA 迷你驅動程式的屬性和方法集合，您應該在此陣列中指定此類型結構的成員。如果您建立 BDA 迷你驅動程式，使其使用 BDA 支援程式庫，則 BDA 迷你驅動程式應該改為呼叫 BdaCreateFilterFactory 支援函式，以為裝置新增篩選處理站描述元 (KSFILTER_DESCRIPTOR結構) 。如需詳細資訊，請參閱啟動 BDA Minidriver 。

下列程式碼片段顯示篩選描述元陣列、BDA 裝置的分派資料表，以及 BDA 裝置的描述項範例：

//
//  Array containing descriptors for all filter factories
//  available on the device.
//
//  Note!  Only used when dynamic topology is not used (that is, 
//         only when filters and pins are fixed). Typically, this 
//         is when the network provider is not present.
//
DEFINE_KSFILTER_DESCRIPTOR_TABLE(FilterDescriptors)
{
    &TemplateTunerFilterDescriptor
};
//
//  Device Dispatch Table
//
//  Lists the dispatch routines for the major events related to 
//  the underlying device.
//
extern
const
KSDEVICE_DISPATCH
DeviceDispatch =
{
    CDevice::Create,    // Add
    CDevice::Start,     // Start
    NULL,               // PostStart
    NULL,               // QueryStop
    NULL,               // CancelStop
    NULL,               // Stop
    NULL,               // QueryRemove
    NULL,               // CancelRemove
    NULL,               // Remove
    NULL,               // QueryCapabilities
    NULL,               // SurpriseRemoval
    NULL,               // QueryPower
    NULL                // SetPower
};
//
//  Device Descriptor
//
//  Brings together the data structures that define the device and
//  the initial filter factories that can be created on it.
//  Note that because template topology structures are specific 
//  to BDA, the device descriptor does not include them.
//  Note also that if BDA dynamic topology is used, the device 
//  descriptor does not specify a list of filter factory descriptors.
//  If BDA dynamic topology is used, the BDA minidriver calls 
//  BdaCreateFilterFactory to add filter factory descriptors. 
extern
const
KSDEVICE_DESCRIPTOR
DeviceDescriptor =
{
    &DeviceDispatch,    // Dispatch
#ifdef DYNAMIC_TOPOLOGY // network provider is present
    0,    // FilterDescriptorsCount
    NULL, // FilterDescriptors
#else     // network provider is not present
    SIZEOF_ARRAY( FilterDescriptors), // FilterDescriptorsCount
    FilterDescriptors                 // FilterDescriptors
#endif // DYNAMIC_TOPOLOGY

共用方式為

初始化 BDA Minidriver

意見反應

其他資源