struttura HW_STREAM_OBJECT (strmini.h)

Articolo
02/29/2024

HW_STREAM_OBJECT descrive un'istanza di un flusso di minidriver.

Sintassi

typedef struct _HW_STREAM_OBJECT {
  ULONG                          SizeOfThisPacket;
  ULONG                          StreamNumber;
  PVOID                          HwStreamExtension;
  PHW_RECEIVE_STREAM_DATA_SRB    ReceiveDataPacket;
  PHW_RECEIVE_STREAM_CONTROL_SRB ReceiveControlPacket;
  HW_CLOCK_OBJECT                HwClockObject;
  BOOLEAN                        Dma;
  BOOLEAN                        Pio;
  PVOID                          HwDeviceExtension;
  ULONG                          StreamHeaderMediaSpecific;
  ULONG                          StreamHeaderWorkspace;
  BOOLEAN                        Allocator;
  PHW_EVENT_ROUTINE              HwEventRoutine;
  ULONG                          Reserved[2];
} HW_STREAM_OBJECT, *PHW_STREAM_OBJECT;

Members

SizeOfThisPacket

Specifica le dimensioni, in byte, di questa struttura.

StreamNumber

Specifica l'offset del flusso all'interno della struttura HW_STREAM_DESCRIPTOR del minidriver.

HwStreamExtension

Punta all'estensione del flusso, un buffer allocato dal driver di classe per il minidriver da usare per contenere informazioni private su questo flusso. Il minidriver imposta le dimensioni del buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra con il driver della classe di flusso.

ReceiveDataPacket

Puntatore alla routine StrMiniReceiveStreamDataPacket del flusso.

ReceiveControlPacket

Puntatore alla routine StrMiniReceiveStreamControlPacket del flusso.

HwClockObject

Contiene l'oggetto orologio del flusso. Per informazioni dettagliate , vedere HW_CLOCK_OBJECT .

Dma

Se TRUE, il dispositivo usa DMA per trasferire i dati per questo flusso.

Pio

Se TRUE, il dispositivo usa l'I/O programmato per trasferire i dati per questo flusso. Si noti che i membri di Pio e Dma possono essere TRUE.

HwDeviceExtension

Puntatore all'estensione del dispositivo del minidriver. Il minidriver può usare questo buffer per registrare informazioni private. Il minidriver imposta le dimensioni di questo buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra tramite StreamClassRegisterMinidriver. Il driver di classe passa anche puntatori a questo buffer nel membro HwDeviceExtension del HW_STREAM_REQUEST_BLOCK, HW_TIME_CONTEXT e PORT_CONFIGURATION_INFORMATION strutture che passa al minidriver.

StreamHeaderMediaSpecific

Specifica le dimensioni in byte dell'estensione di intestazione per flusso specifica del supporto.

StreamHeaderWorkspace

Specifica le dimensioni dell'area di lavoro per ogni intestazione di flusso.

Allocator

Specifica TRUE se il driver utilizza allocatori. La maggior parte dei minidriver imposta questo valore su FALSE.

HwEventRoutine

Puntatore alla routine StrMiniEvent del flusso

Reserved[2]

Riservato per l'utilizzo nel sistema. Non usare.

Commenti

Questa struttura viene creata dal driver di classe per contenere informazioni su un determinato flusso nel minidriver. Per ogni richiesta specifica del flusso, il driver di classe passa il HW_STREAM_OBJECT per il flusso nel membro StreamObject del blocco di richiesta di flusso (vedere HW_STREAM_REQUEST_BLOCK).

Quando il driver di classe apre il flusso e invia la richiesta di SRB_OPEN_STREAM alla routine StrMiniReceiveDevicePacket del minidriver, il minidriver inizializza l'oggetto flusso.

Requisiti

Requisito	Valore
Intestazione	strmini.h (include Strmini.h)

Vedi anche

HW_CLOCK_OBJECT

Condividi tramite