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

Artigo
05/23/2024

A função DxgkCbWriteDeviceSpace grava em um espaço de configuração do dispositivo ou na ROM de expansão de um adaptador de exibição.

Sintaxe

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
)
{...}

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 gravação a ser executada. Esse parâmetro deve ser um dos seguintes valores, que são definidos em Dispmprt.h:

DXGK_WHICHSPACE_BRIDGE

Gravar no espaço de configuração do dispositivo de barramento pai.

DXGK_WHICHSPACE_CONFIG

Gravar no espaço de configuração do adaptador de exibição.

DXGK_WHICHSPACE_MCH

Gravar no 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

Gravar na ROM de expansão do adaptador de exibição.

[in] Buffer

Um ponteiro para um buffer que fornece os dados a serem gravados no espaço de configuração.

[in] Offset

O deslocamento, em bytes, para o espaço de configuração, no qual a transação de gravação começa.

[in] Length

O número de bytes a serem gravados.

[out] BytesWritten

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

Retornar valor

DxgkCbWriteDeviceSpace 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 gravar 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

DxgkCbReadDeviceSpace

Compartilhar via