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
設定するバス データの種類を指定します。 現在、その値は、Cmos、EisaConfiguration、または PCIConfiguration のいずれかです。 ただし、将来、標準化された動的に構成可能なバスの追加の種類がサポートされる可能性があります。 サポートされるバスの種類の上限は、常に MaximumBusDataType です。
SlotNumber
BusDataType 値 Cmosの場合は、バス上のデバイスの場所を指定します。 このパラメーターは、他のすべてのバスの種類に対して 0 にする必要があります。
[in] Buffer
BusDataTypeに固有の構成情報を持つ、呼び出し元が指定した記憶域へのポインター。
PCIConfiguration 指定すると、バッファーには、指定された SlotNumberの PCI_COMMON_CONFIG 情報の一部またはすべてが含まれます。 指定した オフセット と 長さ、提供される情報の量を決定します。
Offset
呼び出し元が指定した構成値が開始されるPCI_COMMON_CONFIG構造体内のバイト オフセットを指定します。 ミニポート ドライバーは、PCI_COMMON_HDR_LENGTHを使用して、PCI_COMMON_CONFIGのデバイス固有領域のオフセットを指定できます。
Length
バッファー のバイト数指定します。
戻り値
VideoPortSetBusData は、指定された SlotNumberに対して正常に設定されたデータのバイト数を返します。 指定された BusDataType が現在のプラットフォームで有効でない場合、または指定された情報が無効な場合、VideoPortSetBusData は 0 を返します。
備考
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 |
関連項目
HalSetBusDataByOffset の
HwVidFindAdapter を する
VideoPortGetBusData の