VideoPortQueryServices 함수(video.h)

아티클
08/08/2023

VideoPortQueryServices 함수는 비디오 포트 드라이버에 의해 구현되는 지정된 인터페이스를 노출합니다.

구문

VIDEOPORT_API VP_STATUS VideoPortQueryServices(
  [in]      IN PVOID               HwDeviceExtension,
  [in]      IN VIDEO_PORT_SERVICES ServicesType,
  [in, out] IN OUT PINTERFACE      Interface
);

매개 변수

[in] HwDeviceExtension

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

[in] ServicesType

요청되는 인터페이스를 지정하는 VIDEO_PORT_SERVICES 열거형 형식의 값입니다.

[in, out] Interface

요청된 인터페이스에 대한 기본 정보를 포함하는 INTERFACE 구조체에 대한 포인터입니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 값

VideoPortQueryServices가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

ServicesType 매개 변수가 VideoPortServicesI2C로 설정된 경우 Interface 매개 변수는 VIDEO_PORT_I2C_INTERFACE 구조체에 대한 포인터여야 하며 INTERFACE 구조체에 대한 포인터로 캐스팅됩니다.

마찬가지로 ServicesType 매개 변수가 VideoPortServicesAGP로 설정된 경우 Interface 매개 변수는 VIDEO_PORT_AGP_INTERFACE 구조 또는 VIDEO_PORT_AGP_INTERFACE_2 구조체에 대한 포인터여야 합니다. 각 매개 변수는 INTERFACE 구조체에 대한 포인터로 캐스팅됩니다.

후자의 구조체에는 AGP 칩셋의 전송 속도를 재설정하는 데 사용되는 AgpSetRate 함수를 가리키는 멤버가 있다는 점을 제외하고 VIDEO_PORT_AGP_INTERFACE 및 VIDEO_PORT_AGP_INTERFACE_2 구조체는 거의 동일합니다. AGP 지원을 쿼리하는 비디오 미니포트 드라이버는 인터페이스가 VIDEO_PORT_AGP_INTERFACE_2 구조를 가리키는VideoPortQueryServices를 먼저 호출해야 합니다. 해당 호출이 실패하면 미니포트 드라이버는 VideoPortQueryServices를 다시 호출할 수 있으며, 이번에는 인터페이스 가 VIDEO_PORT_AGP_INTERFACE 구조를 가리킵니다.

ServicesType 매개 변수가 VideoPortServicesInt10으로 설정된 경우 Interface 매개 변수는 interface 구조체에 대한 포인터로 캐스팅된 VIDEO_PORT_INT10_INTERFACE 구조체에 대한 포인터여야 합니다.

ServicesType 매개 변수가 VideoPortServicesDebugReport로 설정된 경우 Interface 매개 변수는 VIDEO_PORT_DEBUG_REPORT_INTERFACE 구조체에 대한 포인터여야 하며 INTERFACE 구조체에 대한 포인터로 캐스팅됩니다.

ServicesType 매개 변수가 VideoPortServicesWCMemoryProtection으로 설정된 경우 Interface 매개 변수는 interface 구조체에 대한 포인터로 캐스팅된 VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE 구조체에 대한 포인터여야 합니다.

요구 사항

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