// dispmprt.h
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
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The DxgkCbReadDeviceSpace function reads from a device configuration space or the expansion ROM of a display adapter.
DeviceHandle [in]A handle that represents a display adapter. The display miniport driver previously obtained this handle in the DeviceHandle member of the DXGKRNL_INTERFACE structure that was passed to DxgkDdiStartDevice.
DataType [in]The type of read transaction to be performed. This parameter must be one of the following values, which are defined in Dispmprt.h.
Read from the PCI Express (PCIe) root port's configuration space.
Read from the display adapter's configuration space.
Read from the configuration space of a memory controller hub that is a peer to the adapter's parent bus.
Read from the display adapter's expansion ROM.
Buffer [in]A pointer to a caller-allocated buffer that receives the data read from the configuration space or ROM.
Offset [in]The offset, into the configuration space or the expansion ROM, at which the read transaction begins.
Length [in]The number of bytes to be read.
BytesRead [out]A pointer to a ULONG-typed variable that receives the number of bytes actually read.
DxgkCbReadDeviceSpace returns one of the following values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The function succeeded. |
| STATUS_INVALID_PARAMETER | The DeviceHandle, DataType, or Buffer parameter is invalid. |
| STATUS_UNSUCCESSFUL | The function was unable to read the data. |