DXGKCB_READ_DEVICE_SPACE função de retorno de chamada (dispmprt.h)

Artigo
05/23/2024

A função DxgkCbReadDeviceSpace lê de um espaço de configuração do dispositivo ou da ROM de expansão de um adaptador de exibição.

Sintaxe

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

Um identificador que representa um adaptador de exibição. O driver de miniporto de exibição obteve anteriormente esse identificador no membro DeviceHandle da estrutura DXGKRNL_INTERFACE que foi passada para DxgkDdiStartDevice.

[in] DataType

O tipo de transação de leitura a ser executada. Esse parâmetro deve ser um dos seguintes valores, que são definidos em Dispmprt.h.

DXGK_WHICHSPACE_BRIDGE

Leia do espaço de configuração da porta raiz PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

Leia o espaço de configuração do adaptador de exibição.

DXGK_WHICHSPACE_MCH

Leia do espaço de configuração de um hub de controlador de memória que é um par para o barramento pai do adaptador.

DXGK_WHICHSPACE_ROM

Leia a partir da ROM de expansão do adaptador de exibição.

[in] Buffer

Um ponteiro para um buffer alocado pelo chamador que recebe os dados lidos do espaço de configuração ou rom.

[in] Offset

O deslocamento, no espaço de configuração ou na ROM de expansão, no qual a transação de leitura começa.

[in] Length

O número de bytes a serem lidos.

[out] BytesRead

Um ponteiro para uma variável do tipo ULONG que recebe o número de bytes realmente lidos.

Retornar valor

DxgkCbReadDeviceSpace retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_INVALID_PARAMETER	O parâmetro DeviceHandle, DataType ou Buffer é inválido.
STATUS_UNSUCCESSFUL	A função não pôde ler os dados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	dispmprt.h (inclua Dispmprt.h)
IRQL	PASSIVE_LEVEL

Confira também

DxgkCbWriteDeviceSpace

Compartilhar via