Funzione HalSetBusDataByOffset (ntddk.h)

Articolo
02/07/2025

Avvertimento

HalGetBusDataByOffset e HalSetBusDataByOffset sono disponibili per la compatibilità con le versioni precedenti, ma devono essere usati solo se non è possibile usare i metodi consigliati in Accesso allo spazio di configurazione del dispositivo.

Questa funzione imposta i dati di configurazione del bus per un dispositivo su un bus di I/O configurabile dinamicamente con un'interfaccia standard pubblicata.

Sintassi

NTHALAPI ULONG HalSetBusDataByOffset(
  [in] BUS_DATA_TYPE BusDataType,
  [in] ULONG         BusNumber,
  [in] ULONG         SlotNumber,
  [in] PVOID         Buffer,
  [in] ULONG         Offset,
  [in] ULONG         Length
);

Parametri

[in] BusDataType

Dati del bus da impostare. Questo valore può essere PCIConfiguration. Il limite superiore per i tipi supportati è sempre MaximumBusDataType.

[in] BusNumber

Numero assegnato dal sistema e in base zero del bus nei sistemi con diversi autobus dello stesso BusDataType. Questo argomento contiene anche il numero di segmento. Per specificare il numero di segmento, usare (Segmento << 8) | BusNumber

[in] SlotNumber

Numero di slot logico o posizione del dispositivo. Se si specifica PCIConfiguration come BusDataType, questo valore viene specificato come valore PCI_SLOT_NUMBER, ovvero lo slot e i numeri di funzione combinati.

[in] Buffer

Puntatore a un buffer fornito dal chiamante per informazioni di configurazione specifiche di BusDataType.

Se si specifica PCIConfiguration, il buffer contiene le informazioni sullo spazio di configurazione PCI per il numero di funzione e SlotNumber specificato. L'offset e la lunghezza specificati determinano la quantità di informazioni da fornire. Alcuni membri dello spazio di configurazione PCI hanno valori di sola lettura. Il chiamante è responsabile del mantenimento dei valori forniti dal sistema dei membri di sola lettura. Si noti che per un dispositivo PCI di tipo 1, HalSetBusDataByOffset impedisce le scritture nei registri all'interno dell'intestazione comune (primi 256 byte dello spazio di configurazione).

[in] Offset

Offset di byte nella struttura PCI_COMMON_CONFIG in cui iniziano i valori di configurazione forniti dal chiamante. I chiamanti possono usare la costante definita dal sistema PCI_COMMON_HDR_LENGTH per specificare l'area specifica del dispositivo di PCI_COMMON_CONFIG.

[in] Length

Numero di byte nel buffer.

Valore restituito

Il valore restituito è la lunghezza effettiva scritta nello spazio di configurazione.

Osservazioni

Un driver può chiamare questa funzione o HalSetBusData se circostanze insolite o la natura del dispositivo richiede una chiamata di questo tipo. Ad esempio, un driver potrebbe chiamare una di queste funzioni per cancellare un bit nel registro di stato PCI se il dispositivo segnala un'interruzione di destinazione durante l'inizializzazione. In genere, il codice hardware o di avvio configura il dispositivo in modo appropriato.

Quando si accede all'area specifica del dispositivo dello spazio di configurazione PCI, HalSetBusDataByOffset garantisce che questa funzione non legga mai o scriva dati all'esterno dell'intervallo specificato dall'intervallo di input Offset e Length e anche se la lunghezza di input è esattamente un byte o una parola a due byte, questa funzione non accede mai ai dati all'esterno dell'intervallo richiesto.