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가 지정된 경우 버퍼에는 SlotNumber에 지정된 위치부터 시작하여 CMOS(버스 번호가 0과 같음) 또는 ECMOS(버스 번호가 1과 같음) 위치의 내용이 포함됩니다. 미니포트 드라이버의 HwVidFindAdapter 함수는 VIDEO_PORT_CONFIG_INFO 입력 구조의 SystemIoBusNumber 멤버에서 버스 수를 확인할 수 있습니다.
- EisaConfiguration을 지정하면 버퍼에는 CM_EISA_SLOT_INFORMATION 구조체가 포함되고 지정된 슬롯에 대한 CM_EISA_FUNCTION_INFORMATION 구조체가 0개 이상 포함됩니다.
- 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 값이 포함됩니다. |
설명
구성 정보의 일부만 가져오려면 미니포트 드라이버는 오프셋 을 필요한 정보의 바이트 오프셋으로 설정하고 Length 를 필요한 정보의 바이트 수로 설정해야 합니다. 예를 들어 명령 레지스터만 필요한 경우 오프셋 을 이 레지스터의 오프셋으로 설정하고 Length 를 sizeof(USHORT)로 설정합니다.
드라이버는 VideoPortGetBusData 대신 VideoPortGetAccessRanges를 호출하여 하드웨어 리소스를 검색해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | video.h(Video.h 포함) |
| 라이브러리 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |