VideoPortGetDeviceData 関数 (video.h)

VideoPortGetDeviceData 関数は、システムによって検出された構成情報を から取得します。レジストリの \Machine\Hardware\Description ツリー。 この情報はバス固有またはアダプター固有であり、システム ローダーまたは HAL によってレジストリに格納されます。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

パラメーター

HwDeviceExtension

ミニポート ドライバーのデバイス拡張機能へのポインター。

DeviceDataType

要求されるデータの種類をVIDEO_DEVICE_DATA_TYPE値として指定します。通常は VpBusData、VpControllerData、または VpMonitorData のいずれかです。

VpControllerData と VpMonitorData の値は、ARC 準拠のプラットフォームでのみ関連します。 x86 タイプのビデオ アダプターのミニポート ドライバーは、通常、特に EISA バス上のアダプターに 対して VpBusData を指定します。 VpMachineData 値は、将来使用するために予約されています。

CallbackRoutine

要求された情報と共に呼び出されるドライバー提供の HwVidQueryDeviceCallback 関数へのポインター。

Context

CallbackRoutine に渡される呼び出し元によって決定されたコンテキスト パラメーターへのポインター。 通常は 、VIDEO_PORT_CONFIG_INFO バッファーを指します。

戻り値

VideoPortGetDeviceData は、ミニポート ドライバーの HwVidQueryDeviceCallback 関数を構成情報と共に正常に呼び出した場合、NO_ERRORを返します。

注釈

VideoPortGetDeviceData は、ミニポート ドライバーの HwVidInterrupt 関数または HwVidTimer 関数、 VideoPortQueueDpc 関数、または VideoPortSynchronizeExecution へのコールバックから呼び出すことはできません。

VideoPortGetDeviceData が構成情報を取得するレジストリ ツリーは揮発性です。つまり、システムが読み込まれるたびに、システム ローダーまたは HAL によって再作成されます。 この情報はブート プロセスの早い段階で収集され、格納されるため、 VideoPortGetBusData によって返されるバス相対構成情報の方が完成する可能性があります。

要件

こちらもご覧ください

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters