VideoPortInitialize 함수(video.h)

아티클
08/08/2023

VideoPortInitialize 함수는 미니포트 드라이버 초기화의 일부를 수행하여 미니포트 드라이버에 대한 시스템 리소스를 할당합니다.

구문

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

매개 변수

Argument1

운영 체제가 Video Miniport Driver의 DriverEntry라고 하는 포인터입니다.

Argument2

운영 체제가 DriverEntry라고 하는 두 번째 포인터입니다.

HwInitializationData

스택의 VIDEO_HW_INITIALIZATION_DATA 구조체에 대한 포인터입니다. 미니포트 드라이버의 DriverEntry 루틴은 이 구조를 0으로 초기화한 다음 미니포트 드라이버가 지원할 수 있는 비디오 어댑터를 설명하는 드라이버별 구성 정보로 채웠습니다.

HwContext

NULL이어야 합니다.

반환 값

VideoPortInitialize는 초기화 작업의 최종 상태 반환합니다.

설명

모든 비디오 미니포트 드라이버는 DriverEntry 함수에서 VideoPortInitialize를 호출해야 합니다. DriverEntry 는 처음 0이 초기화된 후에만 VideoPortInitialize 를 호출한 다음 VIDEO_HW_INITIALIZATION_DATA 구조를 설정할 수 있습니다. VideoPortInitialize 는 미니포트 드라이버의 DriverEntry 함수에서만 호출할 수 있습니다.

VideoPortInitialize 함수:

미니포트 드라이버의 VIDEO_HW_INITIALIZATION_DATA 사양의 유효성을 확인합니다.
에 메모리를 할당하고 VIDEO_PORT_CONFIG_INFO 구조를 0으로 초기화합니다.
VIDEO_PORT_CONFIG_INFO 가능한 한 많은 어댑터 구성 정보를 채웁니다.
그래픽 어댑터를 나타내기 위해 시스템에서 만든 디바이스 개체의 공용 멤버 중 일부를 채웁니다. 비디오 포트 드라이버는 디바이스 개체를 관리하므로 미니포트 드라이버는 디바이스 개체 세부 정보와 관련이 없습니다.
디바이스 개체의 디바이스 확장에 대한 메모리를 할당하고 0을 초기화합니다. 디바이스 확장은 어댑터별 상태 정보에 대한 각 미니포트 드라이버의 기본 및 전역 스토리지 영역입니다. 미니포트 드라이버는 VIDEO_HW_INITIALIZATION_DATA HwDeviceExtensionSize 멤버의 디바이스 확장 크기를 지정합니다. 비디오 포트 드라이버는 이 디바이스 확장을 호출하는 대부분의 미니포트 드라이버 함수에 전달합니다.
디바이스 확장에 관련 정보를 수집하고 저장합니다.

미니포트 드라이버의 DriverEntry 루틴은 VideoPortInitialize 에서 반환된 값을 호출자에게 다시 전파합니다. 미니포트 드라이버는 이 반환 값을 사용하면 안 됩니다.

요구 사항

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