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에 대한 이 호출에서 반환된 포인터만 참조해야 합니다.

미니포트 드라이버는 길이가 0인 VideoPortGetRomImage를 호출하여 비디오 포트 드라이버에서 할당한 버퍼를 해제할 수 있습니다.

요구 사항

추가 정보

VideoPortScanRom