VideoPortGetBusData 함수(video.h)

아티클
08/07/2023

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