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를 호출하여 비디오 포트 드라이버에서 할당한 버퍼를 해제할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | video.h(Video.h 포함) |
| 라이브러리 | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |