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 구조체가 포함되고, 그 뒤에 지정된 슬롯에 대한 0개 이상의 CM_EISA_FUNCTION_INFORMATION 구조체가 포함됩니다.
- PCIConfiguration 지정된 경우 버퍼에는 지정된 슬롯에 대한 PCI_COMMON_CONFIG 정보가 포함됩니다.
Offset
BusDataType PCIConfiguration 경우 검색해야 하는 PCI 구성 공간에 대한 오프셋을 바이트 단위로 지정합니다. 그렇지 않으면 0입니다. 자세한 내용은 설명 참조하세요.
Length
버퍼길이(바이트)를 지정합니다.
반환 값
VideoPortGetBusDataBuffer작성한 구성 정보의 바이트 수를 반환합니다. 지정된 BusDataType 현재 플랫폼에 유효하지 않은 경우 이 함수는 일반적으로 0을 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| 0 | PCI 버스가 없습니다. |
| 2 | PCI 버스가 있지만 Buffer에는 PCI_COMMON_CONFIG VendorId 멤버의 PCI_INVALID_VENDOR_ID 값이 포함됩니다. |
발언
구성 정보의 일부만 가져오려면 미니포트 드라이버는 Offset 필요한 정보의 바이트 오프셋으로 설정하고 Length 필요한 정보의 바이트 수로 설정해야 합니다. 예를 들어 명령 레지스터만 필요한 경우 Offset 이 레지스터의 오프셋으로 설정하고 Length USHORT(sizeof)로 설정합니다.
드라이버는 videoPortGetBusData 대신 VideoPortGetAccessRanges 호출하여 하드웨어 리소스를 검색해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | video.h(Video.h 포함) |
| 라이브러리 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |