DXGKCB_READ_DEVICE_SPACE 콜백 함수(dispmprt.h)

아티클
05/23/2024

DxgkCbReadDeviceSpace 함수는 디바이스 구성 공간 또는 디스플레이 어댑터의 확장 ROM에서 읽습니다.

구문

DXGKCB_READ_DEVICE_SPACE DxgkcbReadDeviceSpace;

NTSTATUS DxgkcbReadDeviceSpace(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DataType,
  [in]  PVOID Buffer,
  [in]  ULONG Offset,
  [in]  ULONG Length,
  [out] PULONG BytesRead
)
{...}

매개 변수

[in] DeviceHandle

디스플레이 어댑터를 나타내는 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DxgkDdiStartDevice에 전달된 DXGKRNL_INTERFACE 구조체의 DeviceHandle 멤버에서 이 핸들을 얻었습니다.

[in] DataType

수행할 읽기 트랜잭션의 형식입니다. 이 매개 변수는 Dispmprt.h에 정의된 다음 값 중 하나여야 합니다.

DXGK_WHICHSPACE_BRIDGE

PCI Express(PCIe) 루트 포트의 구성 공간에서 읽습니다.

DXGK_WHICHSPACE_CONFIG

디스플레이 어댑터의 구성 공간에서 읽습니다.

DXGK_WHICHSPACE_MCH

어댑터의 부모 버스에 대한 피어인 메모리 컨트롤러 허브의 구성 공간에서 읽습니다.

DXGK_WHICHSPACE_ROM

디스플레이 어댑터의 확장 ROM에서 읽습니다.

[in] Buffer

구성 공간 또는 ROM에서 읽은 데이터를 수신하는 호출자가 할당한 버퍼에 대한 포인터입니다.

[in] Offset

읽기 트랜잭션이 시작되는 구성 공간 또는 확장 ROM에 대한 오프셋입니다.

[in] Length

읽을 바이트 수입니다.

[out] BytesRead

실제로 읽은 바이트 수를 수신하는 ULONG 형식 변수에 대한 포인터입니다.

반환 값

DxgkCbReadDeviceSpace 는 다음 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	함수가 성공했습니다.
STATUS_INVALID_PARAMETER	DeviceHandle, DataType 또는 Buffer 매개 변수가 잘못되었습니다.
STATUS_UNSUCCESSFUL	함수가 데이터를 읽을 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
대상 플랫폼	데스크톱
머리글	dispmprt.h(Dispmprt.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

DxgkCbWriteDeviceSpace

다음을 통해 공유