VideoPortQueryServices 関数 (video.h)

[アーティクル]
03/05/2024

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 パラメーターは、interface 構造体へのポインターとしてキャストされ、VIDEO_PORT_I2C_INTERFACE構造体へのポインターである必要があります。

同様に、ServicesType パラメーターが VideoPortServicesAGP に設定されている場合、Interface パラメーターは、それぞれ INTERFACE 構造体へのポインターとしてキャストされる、VIDEO_PORT_AGP_INTERFACE構造体またはVIDEO_PORT_AGP_INTERFACE_2構造体へのポインターである必要があります。

VIDEO_PORT_AGP_INTERFACEとVIDEO_PORT_AGP_INTERFACE_2構造体はほぼ同じですが、後者の構造体には AgpSetRate 関数を指すメンバーがあり、AGP チップセットの転送速度をリセットするために使用されます。 AGP サポートに対してクエリを実行するビデオミニポートドライバーは、最初に VideoPortQueryServices を呼び出し、 インターフェイス がVIDEO_PORT_AGP_INTERFACE_2構造を指している必要があります。その呼び出しが失敗した場合、ミニポートドライバーは VideoPortQueryServices への別の呼び出しを行うことができます。今回は、VIDEO_PORT_AGP_INTERFACE構造体を指す インターフェイス を使用します。

ServicesType パラメーターが VideoPortServicesInt10 に設定されている場合、Interface パラメーターは、interface 構造体へのポインターとしてキャストされる、VIDEO_PORT_INT10_INTERFACE構造体へのポインターである必要があります。

ServicesType パラメーターが VideoPortServicesDebugReport に設定されている場合、Interface パラメーターは、interface 構造体へのポインターとしてキャストされ、VIDEO_PORT_DEBUG_REPORT_INTERFACE構造体へのポインターである必要があります。

ServicesType パラメーターが VideoPortServicesWCMemoryProtection に設定されている場合、Interface パラメーターは、interface 構造体へのポインターとしてキャストされる、VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE構造体へのポインターである必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	video.h (Video.h を含む)
Library	Videoprt.lib
[DLL]	Videoprt.sys
IRQL	PASSIVE_LEVEL