DXGKCB_READ_DEVICE_SPACE funzione di callback (dispmprt.h)
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 ottenuto in precedenza 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 dell'adattatore di visualizzazione.
DXGK_WHICHSPACE_MCH
Leggere dallo spazio di configurazione di un hub del controller di memoria che è un peer del bus padre dell'adapter.
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 dalla 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 | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | dispmprt.h (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL |