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

Consulte también

DxgkCbWriteDeviceSpace