DXGKCB_WRITE_DEVICE_SPACE callback function (dispmprt.h)
The DxgkCbWriteDeviceSpace function writes to a device configuration space or the expansion ROM of a display adapter.
Syntax
DXGKCB_WRITE_DEVICE_SPACE DxgkcbWriteDeviceSpace;
NTSTATUS DxgkcbWriteDeviceSpace(
[in] HANDLE DeviceHandle,
[in] ULONG DataType,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length,
[out] PULONG BytesWritten
)
{...}
Parameters
[in] DeviceHandle
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.
[in] DataType
The type of write transaction to be performed. This parameter must be one of the following values, which are defined in Dispmprt.h:
DXGK_WHICHSPACE_BRIDGE
Write to the parent bus device's configuration space.
DXGK_WHICHSPACE_CONFIG
Write to the display adapter's configuration space.
DXGK_WHICHSPACE_MCH
Write to the configuration space of a memory controller hub that is a peer to the adapter's parent bus.
DXGK_WHICHSPACE_ROM
Write to the display adapter's expansion ROM.
[in] Buffer
A pointer to a buffer that supplies the data to be written to the configuration space.
[in] Offset
The offset, in bytes, into the configuration space, at which the write transaction begins.
[in] Length
The number of bytes to be written.
[out] BytesWritten
A pointer to a ULONG-typed variable that receives the number of bytes actually written.
Return value
DxgkCbWriteDeviceSpace 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 write the data. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Target Platform | Desktop |
Header | dispmprt.h (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL |