Funzione KsDeviceGetBusData (ks.h)

La funzione KsDeviceGetBusData legge i dati dal bus in cui risiede il dispositivo AVStream specificato.

Sintassi

KSDDKAPI ULONG KsDeviceGetBusData(
  [in] PKSDEVICE Device,
  [in] ULONG     DataType,
  [in] PVOID     Buffer,
  [in] ULONG     Offset,
  [in] ULONG     Length
);

Parametri

[in] Device

Puntatore alla struttura KSDEVICE che rappresenta il dispositivo AVStream specificato per cui devono essere letti i dati del bus.

[in] DataType

Questo parametro indica il tipo di dati del bus da leggere. Zero corrisponde allo spazio di configurazione. Per altre informazioni, vedere la discussione di WhichSpace nella pagina di riferimento per IRP_MN_READ_CONFIG.

[in] Buffer

Puntatore a un buffer che riceve i dati letti dal bus. Deve essere di almeno la lunghezza.

[in] Offset

Questo parametro contiene l'offset di byte nello spazio specificato da DataType da cui vengono letti i dati.

[in] Length

Questo parametro specifica il numero di byte da leggere in Buffer.

Valore restituito

KsDeviceGetBusData restituisce il numero di byte effettivamente letti dal bus. Se si verifica un errore, questo valore è zero.

Commenti

A seconda del driver per il bus in cui risiede il dispositivo specificato, esistono due possibili comportamenti e set di restrizioni per questa funzione. Se il driver del bus specificato supporta lo standard di interfaccia bus (in genere PCI), chiamare questa funzione in IRQL = PASSIVE_LEVEL o DISPATCH_LEVEL. Dopo una chiamata di questo tipo, KsDeviceGetBusData restituisce il numero effettivo di byte letti dallo spazio richiesto. Se, tuttavia, il driver del bus specificato non supporta lo standard dell'interfaccia del bus, AVStream comunica con il driver dell'autobus tramite IoCallDriver. Si noti che questo limita l'uso di KsDeviceGetBusData a IRQL = PASSIVE_LEVEL e significa anche che il valore restituito è 0, in caso di errore o uguale a Length se l'acquisizione dei dati ha avuto esito positivo.

Per garantire la compatibilità, i writer di minidriver possono voler limitare l'uso di KsDeviceGetBusData a IRQL = PASSIVE_LEVEL.

Requisiti

Vedi anche

IoCallDriver

KsDeviceSetBusData