DXGKCB_READ_DEVICE_SPACE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkCbReadDeviceSpace legge da uno spazio di configurazione del dispositivo o dalla ROM di espansione di una scheda di visualizzazione.

Sintassi

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

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 lettura da eseguire. Questo parametro deve essere uno dei valori seguenti, definiti in Dispmprt.h.

DXGK_WHICHSPACE_BRIDGE

Leggere dallo spazio di configurazione della porta radice PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

Leggere dallo spazio di configurazione dell'adattatore di visualizzazione.

DXGK_WHICHSPACE_MCH

Leggere dallo spazio di configurazione di un hub controller di memoria che è un peer del bus padre della scheda.

DXGK_WHICHSPACE_ROM

Leggere dal ROM di espansione dell'adattatore di visualizzazione.

[in] Buffer

Puntatore a un buffer allocato dal chiamante che riceve i dati letti dallo spazio di configurazione o dal ROM.

[in] Offset

Offset, nello spazio di configurazione o nella ROM di espansione, in corrispondenza del quale inizia la transazione di lettura.

[in] Length

Numero di byte da leggere.

[out] BytesRead

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

Valore restituito

DxgkCbReadDeviceSpace 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 leggere 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

DxgkCbWriteDeviceSpace

Condividi tramite