Funzione StreamClassRegisterAdapter (strmini.h)
La routine StreamClassRegisterAdapter registra un minidriver di classe di flusso.
Il nome StreamClassRegisterAdapter è supportato solo per la compatibilità con le versioni precedenti.
Microsoft consiglia invece l'uso di StreamClassRegisterMinidriver, alias di StreamClassRegisterAdapter. Il nome StreamClassRegisterMinidriver indica in modo più accurato che la routine registra un minidriver di classe di flusso. Dopo la registrazione, un minidriver può guidare qualsiasi numero di istanze dell'adattatore in un sistema.
La routine StreamClassRegisterMinidriver registra un minidriver di flusso con il driver della classe di flusso.
Sintassi
NTSTATUS STREAMAPI StreamClassRegisterAdapter(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] PHW_INITIALIZATION_DATA HwInitializationData
);
Parametri
[in] Argument1
Punta al primo argomento della routine DriverEntry del minidriver.
[in] Argument2
Punta al secondo argomento alla routine DriverEntry del minidriver.
[in] HwInitializationData
Punta a una struttura HW_INITIALIZATION_DATA che fornisce le informazioni necessarie per iniziare a inizializzare il minidriver.
Valore restituito
Restituisce STATUS_SUCCESS in caso di esito positivo o il codice di errore appropriato in caso di errore.
Commenti
Un minidriver di flusso deve chiamare StreamClassRegisterMinidriver all'interno della routine DriverEntry .
Il minidriver di flusso DriverEntry inizializza un minidriver di classe di flusso. Questa routine è necessaria.
Argument1 Fornisce un valore di contesto con cui il minidriver dell'adattatore deve chiamare StreamClassRegisterMinidriver. Per Windows 2000 e versioni successive, questo punta a un DRIVER_OBJECT.
Argument2 Fornisce un secondo valore di contesto con cui il minidriver della scheda deve chiamare StreamClassRegisterMinidriver. Per Windows 2000 e versioni successive, questo punta a un percorso del Registro di sistema.
DriverEntry restituisce il valore restituito dalla chiamata a StreamClassRegisterMinidriver.
Note DriverEntry è il punto di ingresso iniziale per un minidriver di classe di flusso.
Poiché StreamClassRegisterMinidriver esegue la maggior parte dell'inizializzazione del driver necessaria, l'attività primaria di una routine driverEntry della classe di flusso consiste nell'allocare e compilare una struttura HW_INITIALIZATION_DATA con costanti e punti di ingresso specifici del driver. DriverEntry deve quindi chiamare StreamClassRegisterMinidriver.
La maggior parte delle informazioni passate nella struttura HW_INITIALIZATION_DATA informa il driver di classe dei callback a livello di minidriver e i buffer di dimensioni da allocare per le strutture di dati del minidriver. Il driver di classe esegue una query sul minidriver per informazioni di avvio aggiuntive tramite SRB_INITIALIZE_DEVICE e SRB_GET_STREAM_INFO richieste alla routine StrMiniReceiveDevicePacket del minidriver (passata come membro HwReceivePacket di HW_INITIALIZATION_DATA).
Dopo la registrazione, un minidriver può guidare qualsiasi numero di istanze dell'adattatore in un sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | strmini.h (include Strmini.h) |