Funzione KsSetMajorFunctionHandler (ks.h)

Articolo
02/26/2024

La funzione KsSetMajorFunctionHandler imposta il gestore per una funzione principale specificata per usare il dispatching interno. Instrada attraverso una KSDISPATCH_TABLE contenuta nell'intestazione dell'oggetto opaco per essere il primo elemento all'interno di una struttura a cui punta un fsContext all'interno di un oggetto file. L'invio presuppone che la tabella e la struttura FsContext vengano inizializzate dal dispositivo usando KsAllocateObjectHeader.

Sintassi

KSDDKAPI NTSTATUS KsSetMajorFunctionHandler(
  [in] PDRIVER_OBJECT DriverObject,
  [in] ULONG          MajorFunction
);

Parametri

[in] DriverObject

Specifica l'oggetto driver la cui funzione principale deve essere gestita.

[in] MajorFunction

Specifica l'identificatore di funzione principale da gestire. Questo imposta il puntatore della funzione principale nell'oggetto driver a una funzione interna che quindi invia alla funzione KSDISPATCH_TABLE . Si presuppone che il puntatore a questa tabella sia il primo elemento in una struttura a cui fa riferimento FsContext nell'oggetto file dell'IRP specifico inviato. Gli identificatori di funzione principali validi sono elencati.

Identificatore	Descrizione
IRP_MJ_CREATE	Create IRP. In questa istanza, una richiesta di creazione può essere usata per la creazione di una nuova istanza di un filtro o per la creazione di un oggetto, ad esempio un pin sotto un filtro o un orologio sotto un pin. Ciò presuppone che il primo elemento nell'estensione dell'oggetto driver contenga una struttura KSDEVICE_HEADER usata per trovare il tipo di oggetto da creare, in base al nome passato. Se viene specificato un oggetto file padre, tale oggetto KSDISPATCH_TABLE. ChildCreateHandlerTable in FsContext viene esaminato per determinare quale gestore usare per la creazione o usare la tabella dell'oggetto dispositivo.
IRP_MJ_CLOSE	Chiudere IRP.
IRP_MJ_DEVICE_CONTROL	IRP del controllo del dispositivo.
IRP_MJ_READ	Leggere IRP.
IRP_MJ_WRITE	Scrivere IRP.
IRP_MJ_FLUSH_BUFFERS	Scarica IRP.
IRP_MJ_QUERY_SECURITY	Eseguire query sulle informazioni di sicurezza.
IRP_MJ_SET_SECURITY	Impostare le informazioni di sicurezza.
KSDISPATCH_FASTIO	Questo flag può essere aggiunto all'identificatore MajorFunction per specificare che la voce fa riferimento alla tabella di invio di I/O veloce anziché alla tipica voce della funzione principale. Questa operazione è valida solo con IRP_MJ_READ, IRP_MJ_WRITE o IRP_MJ_DEVICE_CONTROL. Il driver è responsabile della creazione della tabella DriverObject-FastIoDispatch>. Come per il normale invio, se un gestore è impostato per l'oggetto driver, tutti gli oggetti file devono gestire tale I/O veloce, anche se la voce punta solo a DispatchFastIoDeviceControlFailure o una funzione simile.

Valore restituito

Restituisce STATUS_SUCCESS se l'identificatore MajorFunction è valido.

Commenti

Se un gestore delle funzioni principale è impostato per un oggetto driver, tutti gli oggetti file devono gestire tale funzione principale, anche se la voce punta solo a KsDispatchInvalidDeviceRequest.

KSDISPATCH_FASTIO

Questo flag può essere usato per specificare che la voce di I/O rapida deve essere impostata anziché la voce basata su IRP.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib

Condividi tramite