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

BusDataTypePCIConfiguration인 경우 검색해야 하는 PCI 구성 공간에 대한 오프셋(바이트)을 지정합니다. 그렇지 않으면 0입니다. 자세한 내용은 설명을 참조하세요.

Length

버퍼의 길이(바이트)를 지정합니다.

반환 값

VideoPortGetBusData버퍼에 쓴 구성 정보의 바이트 수를 반환합니다. 지정된 BusDataType 이 현재 플랫폼에 유효하지 않은 경우 이 함수는 일반적으로 0을 반환합니다.

반환 코드 설명
0 PCI 버스가 없습니다.
2 PCI 버스가 있지만 Buffer에는 PCI_COMMON_CONFIG VendorId 멤버에 PCI_INVALID_VENDOR_ID 값이 포함됩니다.

설명

구성 정보의 일부만 가져오려면 미니포트 드라이버는 오프셋 을 필요한 정보의 바이트 오프셋으로 설정하고 Length 를 필요한 정보의 바이트 수로 설정해야 합니다. 예를 들어 명령 레지스터만 필요한 경우 오프셋 을 이 레지스터의 오프셋으로 설정하고 Lengthsizeof(USHORT)로 설정합니다.

드라이버는 VideoPortGetBusData 대신 VideoPortGetAccessRanges를 호출하여 하드웨어 리소스를 검색해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 video.h(Video.h 포함)
라이브러리 Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

추가 정보

CM_EISA_FUNCTION_INFORMATION

CM_EISA_SLOT_INFORMATION

HwVidQueryDeviceCallback

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VIDEO_PORT_CONFIG_INFO

VideoPortGetAccessRanges

VideoPortGetDeviceBase

VideoPortGetDeviceData

VideoPortGetRegistryParameters