DXGKCB_WRITE_DEVICE_SPACE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkCbWriteDeviceSpace scrive in uno spazio di configurazione del dispositivo o nella ROM di espansione di una scheda di visualizzazione.

Sintassi

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

Parametri

[in] DeviceHandle

Handle che rappresenta una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente ottenuto questo handle nel membro DeviceHandle del DXGKRNL_INTERFACE passato a DxgkDdiStartDevice.

[in] DataType

Tipo di transazione di scrittura da eseguire. Questo parametro deve essere uno dei valori seguenti, definiti in Dispmprt.h:

DXGK_WHICHSPACE_BRIDGE

Scrivere nello spazio di configurazione del dispositivo bus padre.

DXGK_WHICHSPACE_CONFIG

Scrivere nello spazio di configurazione dell'adattatore di visualizzazione.

DXGK_WHICHSPACE_MCH

Scrivere nello spazio di configurazione di un hub controller di memoria peer del bus padre dell'adapter.

DXGK_WHICHSPACE_ROM

Scrivere nella ROM di espansione dell'adattatore di visualizzazione.

[in] Buffer

Puntatore a un buffer che fornisce i dati da scrivere nello spazio di configurazione.

[in] Offset

Offset, in byte, nello spazio di configurazione in cui inizia la transazione di scrittura.

[in] Length

Numero di byte da scrivere.

[out] BytesWritten

Puntatore a una variabile tipizzata ULONG che riceve il numero di byte effettivamente scritti.

Valore restituito

DxgkCbWriteDeviceSpace restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_INVALID_PARAMETER	Il parametro DeviceHandle, DataType o Buffer non è valido.
STATUS_UNSUCCESSFUL	La funzione non è riuscita a scrivere i dati.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedere anche

DxgkCbReadDeviceSpace

Condividi tramite