VideoPortSetBusData 함수(video.h)

아티클
03/01/2024

VideoPortSetBusData 함수는 게시된 표준 인터페이스를 사용하여 동적으로 구성 가능한 I/O 버스의 어댑터에 대한 버스 구성 데이터를 설정합니다.

구문

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortSetBusData(
       PVOID         HwDeviceExtension,
       BUS_DATA_TYPE BusDataType,
       ULONG         SlotNumber,
  [in] PVOID         Buffer,
       ULONG         Offset,
       ULONG         Length
);

매개 변수

HwDeviceExtension

미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

BusDataType

설정할 버스 데이터의 형식을 지정합니다. 현재 해당 값은 Cmos, EisaConfiguration 또는 PCIConfiguration 중 하나일 수 있습니다. 그러나 향후 추가 유형의 표준화되고 동적으로 구성 가능한 버스가 지원될 수 있습니다. 지원되는 버스 유형의 상한은 항상 MaximumBusDataType입니다.

SlotNumber

Cmos의 BusDataType 값에 대해 는 버스에서 디바이스의 위치를 지정합니다. 이 매개 변수는 다른 모든 버스 유형에 대해 0이어야 합니다.

[in] Buffer

BusDataType과 관련된 구성 정보가 있는 호출자 제공 스토리지 영역에 대한 포인터입니다.

PCIConfiguration을 지정하면 버퍼에 지정된 SlotNumber에 대한 PCI_COMMON_CONFIG 정보의 일부 또는 전부가 포함됩니다. 지정한 오프셋 및 길이 는 제공되는 정보의 양을 결정합니다.

Offset

호출자가 제공한 구성 값이 시작되는 PCI_COMMON_CONFIG 구조 내에서 바이트 오프셋을 지정합니다. 미니포트 드라이버는 PCI_COMMON_HDR_LENGTH 사용하여 PCI_COMMON_CONFIG 디바이스별 영역의 오프셋을 지정할 수 있습니다.

Length

버퍼의 바이트 수를 지정합니다.

반환 값

VideoPortSetBusData 는 지정된 SlotNumber에 대해 성공적으로 설정된 데이터 바이트 수를 반환합니다. 지정된 BusDataType 이 현재 플랫폼에 유효하지 않거나 제공된 정보가 잘못된 경우 VideoPortSetBusData 는 0을 반환합니다.

설명

PCI 버스의 어댑터 미니포트 드라이버는 비정상적인 상황이나 특정 드라이버 비디오 어댑터의 특성에 따라 이러한 호출이 필요하지 않는 한 VideoPortSetBusData를 거의 호출하지 않습니다.

예를 들어 미니포트 드라이버는 VideoPortSetBusData를 호출하여 초기화 중에 어댑터가 대상 중단을 알리는 경우 PCI 상태 레지스터에서 비트를 지울 수 있습니다. PCI 비디오 어댑터를 디바이스별 데이터로 구성해야 하는 경우 드라이버도 이 함수를 호출합니다. 두 경우 모두 이러한 드라이버는 RequestResources 포인터를 사용하여 VideoPortGetAccessRanges를 드라이버 제공 리소스 설명자 배열에 호출할 가능성이 높습니다.

VideoPortSetBusData 는 미니포트 드라이버의 HwVidInterrupt 또는 HwVidTimer 함수 또는 VideoPortQueueDpc 또는 VideoPortSynchronizeExecution 콜백에서 호출할 수 없습니다.

요구 사항

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