PMINIPORT_GET_REGISTRY_ROUTINE コールバック関数 (video.h)

[アーティクル]
08/07/2023

HwVidQueryNamedValueCallback は、レジストリから取得した指定されたデータを処理します。

構文

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

パラメーター

HwDeviceExtension

ミニポートドライバーのアダプターごとの記憶域へのポインター。詳細については、「デバイス拡張機能」を参照してください。

Context

VideoPortGetRegistryParameters 関数への入力として指定されたドライバーによって決定されたコンテキストへのポインター。

ValueName

エントリに名前を付ける NULL で終わる Unicode 文字列へのポインター。

ValueData

VideoPortGetRegistryParameters によって提供される、ValueName に関連付けられているバッファーされたデータへのポインター。

ValueLength

ValueData のバッファーのサイズをバイト単位で指定します。

戻り値

HwVidQueryNamedValueCallback は、操作の状態を返します。

注釈

HwVidQueryNamedValueCallback は、 VideoPortGetRegistryParameters の呼び出しで渡される省略可能なミニポートドライバー関数です。

VideoPortGetRegistryParameters は、レジストリのアダプター キーで指定された ValueName に関する利用可能な構成情報を収集した後、HwVidQueryNamedValueCallback を呼び出します。

HwVidFindAdapter または HwVidInitialize は、ドライバー指定の HwVidQueryNamedValueCallback 関数、デバイス拡張機能へのポインター、およびドライバーが提供するコンテキストデータ (VIDEO_PORT_CONFIG_INFO バッファーである可能性があります)、およびレジストリから取得する値を指定する Unicode 文字列へのポインターを使用して VideoPortGetRegistryParameters を呼び出すことができます。

ドライバーが指定した Unicode 文字列がファイル名の名前付きレジストリエントリである場合、HwVidFindAdapter または HwVidInitialize は VideoPortGetRegistryParameters の IsFileNameParameter 引数を TRUE に設定できます。この仕様では、返されるデータは名前付きファイルの内容になります。

VideoPortGetRegistryParameters が HwVidQueryNamedValueCallback 関数を呼び出すと、使用可能になった構成データが処理されます。たとえば、 HwVidQueryNamedValueCallback では、取得したデータを使用してミニポートドライバーのアクセス範囲を決定し、エミュレーターのアクセス範囲 (存在する場合)、割り込みベクターまたは割り込み IRQL (存在する場合) などを、VIDEO_PORT_CONFIG_INFO バッファーやミニポートドライバーのデバイス拡張機能に設定してから 、HwVidFindAdapter 関数に制御を返すことができます。

また、HwVidInitialize は、IsFileNameParameter を TRUE に設定して VideoPortGetRegistryParameters を呼び出して、ミニポートドライバーが提供する HwVidQueryNamedValueCallback 関数が、名前付きファイルのバッファーされた内容を使用してアダプターにマイクロコードを設定できるようにすることもできます。

返された ValueData はスタック上にあり、ローカルで参照できます。 HwVidQueryNamedValueCallback は、他のミニポートドライバー関数で使用するために返された情報の一部またはすべてを入力 HwDeviceExtension に格納するか、入力 コンテキスト をデータを格納できる場所へのポインターとして使用できます。

HwVidQueryNamedValueCallback をページング可能にする必要があります。