Condividi tramite

Funzione StreamClassCallAtNewPriority (strmini.h)

  • Articolo

La routine StreamClassCallAtNewPriority pianifica una routine da chiamare in una priorità diversa.

Sintassi

VOID STREAMAPI StreamClassCallAtNewPriority(
  [in, optional] PHW_STREAM_OBJECT    StreamObject,
  [in]           PVOID                HwDeviceExtension,
  [in]           STREAM_PRIORITY      Priority,
  [in]           PHW_PRIORITY_ROUTINE PriorityRoutine,
  [in]           PVOID                Context
);

Parametri

[in, optional] StreamObject

Puntatore a una struttura HW_STREAM_OBJECT che specifica il flusso è associato alla routine o NULL se la routine è associata al dispositivo nel suo complesso. È possibile usare una sola routine per flusso e una sola routine per il dispositivo. Questo parametro è facoltativo e,

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del minidriver. Il minidriver specifica le dimensioni di questo buffer nella struttura HW_INITIALIZATION_DATA che passa quando si registra tramite StreamClassRegisterMinidriver. Il driver di classe passa quindi puntatori al buffer nel membro HwDeviceExtension del HW_STREAM_REQUEST_BLOCK,HW_STREAM_OBJECT, HW_TIME_CONTEXT e PORT_CONFIGURATION_INFORMATION strutture che passa al minidriver.

[in] Priority

Specifica uno dei valori elencati nella tabella seguente.

Priorità Utilizzo
Alto Il driver della classe di flusso chiama la routine con la stessa priorità dei callback StrMiniXxx del minidriver. Non usare questa impostazione a meno che la routine non sia sincronizzata con la routine di interruzione del minidriver.
Dispatch Il driver della classe di flusso chiama la routine in DISPATCH_LEVEL. Usare questa priorità se la routine richiede meno di 1 millisecondo per completare.
Basso Il driver della classe di flusso chiama la routine in PASSIVE_LEVEL. Usare questa priorità se la routine richiede meno di 1 millisecondo per completare.
LowToHigh Usato per consentire a un thread chiamato a bassa priorità di tornare ad alta priorità in modo che sia possibile chiamare altri servizi driver di classe di flusso.

[in] PriorityRoutine

Puntatore a un minidriver fornito da StrMiniPriorityRoutine da chiamare a livello di priorità specificato.

[in] Context

Specifica il parametro da passare a PriorityRoutine.

Valore restituito

nessuno

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione strmini.h (include Strmini.h)
Libreria Stream.lib
IRQL (Vedere la sezione Parametri)