DXGKCB_READ_DEVICE_SPACE función de devolución de llamada (dispmprt.h)
La función DxgkCbReadDeviceSpace lee desde un espacio de configuración de dispositivo o la ROM de expansión de un adaptador de pantalla.
Sintaxis
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
)
{...}
Parámetros
[in] DeviceHandle
Identificador que representa un adaptador de pantalla. El controlador de minipuerto de pantalla obtuvo previamente este identificador en el miembro DeviceHandle de la estructura de DXGKRNL_INTERFACE que se pasó a DxgkDdiStartDevice.
[in] DataType
Tipo de transacción de lectura que se va a realizar. Este parámetro debe ser uno de los siguientes valores, que se definen en Dispmprt.h.
DXGK_WHICHSPACE_BRIDGE
Lea el espacio de configuración del puerto raíz de PCI Express (PCIe).
DXGK_WHICHSPACE_CONFIG
Lea desde el espacio de configuración del adaptador de pantalla.
DXGK_WHICHSPACE_MCH
Lea desde el espacio de configuración de un centro de controlador de memoria que es un elemento del mismo nivel para el bus primario del adaptador.
DXGK_WHICHSPACE_ROM
Lee desde el ROM de expansión del adaptador de pantalla.
[in] Buffer
Puntero a un búfer asignado por el autor de la llamada que recibe los datos leídos del espacio de configuración o rom.
[in] Offset
Desplazamiento, en el espacio de configuración o en la ROM de expansión, en el que comienza la transacción de lectura.
[in] Length
Número de bytes que se van a leer.
[out] BytesRead
Puntero a una variable con tipo ULONG que recibe el número de bytes leídos realmente.
Valor devuelto
DxgkCbReadDeviceSpace devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se realizó correctamente. |
| STATUS_INVALID_PARAMETER | El parámetro DeviceHandle, DataType o Buffer no es válido. |
| STATUS_UNSUCCESSFUL | La función no pudo leer los datos. |
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| de la plataforma de destino de | Escritorio |
| encabezado de | dispmprt.h (incluya Dispmprt.h) |
| irQL | PASSIVE_LEVEL |