DXGKCB_READ_DEVICE_SPACE funzione di callback (dispmprt.h)

La funzione DxgkCbReadDeviceSpace legge da uno spazio di configurazione del dispositivo o dall'espansione ROM 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 visualizzato in precedenza ha ottenuto questo handle nel membro DeviceHandle della struttura DXGKRNL_INTERFACE passata 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 della scheda di visualizzazione.

DXGK_WHICHSPACE_MCH

Leggere dallo spazio di configurazione di un hub controller di memoria che è un peer del bus padre dell'adattatore.

DXGK_WHICHSPACE_ROM

Leggere dalla 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 da 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	Funzione completata.
STATUS_INVALID_PARAMETER	Il parametro DeviceHandle, DataType o Buffer non è valido.
STATUS_UNSUCCESSFUL	La funzione non è riuscita a leggere i dati.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedi anche

DxgkCbWriteDeviceSpace