VideoPortSetBusData 関数 (video.h)

[アーティクル]
02/29/2024

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