DXGKCB_READ_DEVICE_SPACE función de devolución de llamada (dispmprt.h)
La función DxgkCbReadDeviceSpace lee desde un espacio de configuración del 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 valores siguientes, que se definen en Dispmprt.h.
DXGK_WHICHSPACE_BRIDGE
Lea en el espacio de configuración del puerto raíz de PCI Express (PCIe).
DXGK_WHICHSPACE_CONFIG
Lee desde el espacio de configuración del adaptador de pantalla.
DXGK_WHICHSPACE_MCH
Lea desde el espacio de configuración de un concentrador de controlador de memoria que es un elemento del mismo nivel del bus primario del adaptador.
DXGK_WHICHSPACE_ROM
Lee desde la 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 va 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 ha realizado 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h (incluir Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |