VideoPortGetBusData 関数 (video.h)
VideoPortGetBusData 関数は、バスの種類固有の構成情報を返します。
構文
VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
PVOID HwDeviceExtension,
BUS_DATA_TYPE BusDataType,
ULONG SlotNumber,
[out] PVOID Buffer,
ULONG Offset,
ULONG Length
);
パラメーター
HwDeviceExtension
ミニポート ドライバーのデバイス拡張機能へのポインター。
BusDataType
返されるバス構成データの種類を指定します。 このパラメーターの値は、Cmos 、EisaConfiguration、または PCIConfiguration できます。 ただし、今後、追加の種類のバス構成がサポートされる可能性があります。 サポートされている型の上限は、常に MaximumBusDataType です。
SlotNumber
Cmos BusDataTypeのバス上のデバイスの場所を指定します。他のすべてのバスの種類の場合は 0。
[out] Buffer
VideoPortGetBusData が構成情報を返すバッファーへのポインター。 バッファーの内容は、次のように、BusDataTypeによって異なります。
- cmos 指定した場合、バッファーには CMOS (バス番号が 0 に等しい) または E CMOS (バス番号が 1 と等しい) 位置の内容 SlotNumberに指定された位置から始まります。 ミニポート ドライバーの HwVidFindAdapter 関数は、VIDEO_PORT_CONFIG_INFO 入力構造体の SystemIoBusNumber メンバーからのバスの数を決定できます。
- EisaConfiguration が指定されている場合、バッファーには CM_EISA_SLOT_INFORMATION 構造体が格納され、その後に指定されたスロットの 0 個以上の CM_EISA_FUNCTION_INFORMATION 構造体が格納されます。
- PCIConfiguration 指定した場合、バッファーには、指定したスロットの PCI_COMMON_CONFIG 情報が含まれます。
Offset
BusDataType が PCIConfiguration 場合に取得する必要がある PCI 構成領域へのオフセットをバイト単位で指定します。それ以外の場合は 0。 詳細については、「解説」を参照してください。
Length
バッファー の長さをバイト単位指定します。
戻り値
VideoPortGetBusData は、バッファー に書き込まれた構成情報のバイト数返します。 指定された BusDataType が現在のプラットフォームで有効でない場合、通常、この関数は 0 を返します。
| リターン コード | 形容 |
|---|---|
| 0 | PCI バスが存在しません。 |
| 2 | PCI バスは存在しますが、Buffer には PCI_COMMON_CONFIG VendorId メンバーのPCI_INVALID_VENDOR_ID値が含まれています。 |
備考
構成情報の一部のみを取得するには、ミニポート ドライバーは、必要な情報のバイト オフセット オフセットを設定し、必要な情報のバイト数に 長さを設定する必要があります。 たとえば、コマンド レジスタのみが必要な場合は、Offset をこのレジスタのオフセットに設定し、Length を sizeof(USHORT) に設定します。
ドライバーは、ハードウェア リソースを取得するために VideoPortGetBusData を するのではなく、VideoPortGetAccessRanges 呼び出す必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | video.h (Video.h を含む) |
| ライブラリ | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |
関連項目
HwVidQueryDeviceCallback の
VideoPortGetDeviceBase の
VideoPortGetDeviceData の