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
設定するバス データの種類を指定します。 現在、値には Cmos、 EisaConfiguration、 PCIConfiguration のいずれかを指定できます。 ただし、今後、標準化された動的に構成可能なバスの追加の種類がサポートされる可能性があります。 サポートされているバスの種類の上限は常に MaximumBusDataType です。
SlotNumber
BusDataType 値が Cmos の場合、バス上のデバイスの場所を指定します。 このパラメーターは、他のすべてのバスの種類では 0 にする必要があります。
[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 は 0 を返します。
注釈
PCI バス上のアダプターのミニポート ドライバーは、通常とは異なる状況や特定のドライバーのビデオ アダプターの性質がこのような呼び出しを必要とする場合を除き、 VideoPortSetBusData を呼び出すことはほとんどありません。
たとえば、ミニポート ドライバーが VideoPortSetBusData を呼び出して、初期化中にアダプターからターゲットの中止が通知された場合、PCI 状態レジスタのビットをクリアできます。 PCI ビデオ アダプターをデバイス固有のデータで構成する必要がある場合、そのドライバーもこの関数を呼び出します。 どちらの場合も、このようなドライバーは、リソース記述子のドライバー指定配列への RequestedResources ポインターを使用して VideoPortGetAccessRanges を呼び出す可能性があります。
VideoPortSetBusData は、ミニポート ドライバーの HwVidInterrupt 関数または HwVidTimer 関数、 VideoPortQueueDpc 関数、または VideoPortSynchronizeExecution へのコールバックから呼び出すことはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |
| Library | Videoprt.lib |
| [DLL] | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |