VideoPortGetRomImage 関数 (video.h)

デバイスの読み取り専用メモリ (ROM) を読み取ります。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetRomImage(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID Unused1,
  [in] IN ULONG Unused2,
  [in] IN ULONG Length
);

パラメーター

[in] HwDeviceExtension

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

[in] Unused1

現在、ビデオ ポート ドライバーでは無視されます。 は NULL に設定する必要があります。

[in] Unused2

現在、ビデオ ポート ドライバーでは無視されます。は 0 に設定する必要があります。

[in] Length

ビデオ ポート ドライバーが読み取って返す必要がある ROM データのバイト数、または 0 のいずれか。

戻り値

VideoPortGetRomImage は、成功したデバイスの ROM (BIOS) データを含むバッファーへのポインターを返します。それ以外の場合は NULL を 返し、操作に十分なメモリがなかったか、デバイスの ROM にアクセスできなかったことを示します。

注釈

VideoPortGetRomImage は、レガシ 0xC0000 マッピングを使用して ROM を読み取りません。 ACPI_METHOD_DISPLAY_ROMメソッドまたは ROM ベース アドレス レジスタを使用して検出できる ROM を読み取ります。

Dispmprt.h で定義されているACPI_METHOD_DISPLAY_ROMエイリアスは、BIOS ROM イメージの取得に使用されるメソッドを表します。 この方法は、ROM イメージがシステム BIOS ROM などの独自の形式で格納されている場合に必要です。 この方法は、標準の PCI インターフェイスを介して ROM イメージを読み取ることができる場合は必要ありません。

ビデオ ポート ドライバーは 、長さ バイトのバッファーを割り当て、デバイスの ROM から読み取られたデータで埋めます。 ビデオ ポート ドライバーは、常にデバイスの ROM の先頭から 長さ バイトを読み取ります。

ミニポート ドライバーが VideoPortGetRomImage を 複数回呼び出す場合、ビデオ ポート ドライバーは、現在の呼び出しでバッファーを割り当て、返す前に、以前の呼び出しからバッファーを解放します。 したがって、ミニポート ドライバーは、 VideoPortGetRomImage へのこの呼び出しによって返されるポインターのみを参照する必要があります。

ミニポート ドライバーは、 VideoPortGetRomImage を 0 の 長さで 呼び出すことによって、ビデオ ポート ドライバーによって割り当てられたバッファーを解放できます。

要件

こちらもご覧ください

VideoPortScanRom