VideoPortSetBusData 函式 (video.h)
VideoPortSetBusData 函式會在動態設定的 I/O 總線上設定適配卡的總線組態數據,其中包含已發佈的標準介面。
語法
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[in] PVOID Buffer,
ULONG Offset,
ULONG Length
);
參數
HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
BusDataType
指定要設定的總線數據類型。 目前,其值可以是其中一個 [Azure]、 [EisaConfiguration] 或 [PCIConfiguration]。 不過,未來可能會支援其他標準化且可動態設定的總線類型。 支援的總線類型上限一律為 MaximumBusDataType。
SlotNumber
若為 BusDataType 值,指定總線上的裝置位置。 所有其他總線類型都應該為零這個參數。
[in] Buffer
呼叫端提供的儲存區域指標,其中包含 BusDataType 專屬的組態資訊。
指定PCIConfiguration時,緩衝區會包含指定 SlotNumber 的一些或所有PCI_COMMON_CONFIG資訊。 指定的 Offset 和 Length 會決定提供多少資訊。
Offset
指定呼叫端提供的組態值開始所在PCI_COMMON_CONFIG結構內的位元組位移。 迷你埠驅動程式可以使用PCI_COMMON_HDR_LENGTH,在 PCI_COMMON_CONFIG 中指定裝置特定區域的位移。
Length
指定 Buffer 中的位元元組數目。
傳回值
VideoPortSetBusData 會傳回為指定 SlotNumber 成功設定的數據位元組數目。 如果指定的 BusDataType 對目前平台無效,或提供的資訊無效, VideoPortSetBusData 會傳回零。
備註
PCI 總線上適配卡的迷你埠驅動程式很少呼叫 VideoPortSetBusData,除非特殊情況或特定驅動程式視訊配接器的性質需要這類通話。
例如,迷你埠驅動程式可能會呼叫 VideoPortSetBusData ,在初始化期間清除 PCI 狀態快存器中的位。 如果PCI視訊適配卡必須設定裝置特定數據,其驅動程式也會呼叫此函式。 不論是哪一種情況,這類驅動程式都可能會使用 RequestedResources 指標呼叫 VideoPortGetAccessRanges,以驅動程式提供的資源描述元數位。
VideoPortSetBusData 無法從迷你埠驅動程式的 HwVidInterrupt 或 HwVidTimer 函式,或從 VideoPortQueueDpc 或從回呼呼叫 VideoPortSynchronizeExecution。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
目標平台 | 桌面 |
標頭 | video.h (包含 Video.h) |
程式庫 | Videoprt.lib |
Dll | Videoprt.sys |
IRQL | PASSIVE_LEVEL |