Funzione KsFastMethodHandler (ks.h)

La funzione KsFastMethodHandler gestisce i metodi rapidi richiesti tramite IOCTL_KS_METHOD. Risponde a tutti gli identificatori di metodo definiti dai set contenuti anche nell'elenco di I/O rapido. Questa funzione può essere chiamata solo in PASSIVE_LEVEL.

Sintassi

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

Parametri

[in] FileObject

Specifica l'oggetto file in cui è stata effettuata la richiesta.

[in] Method

Specifica il parametro del metodo originale. Questo sarà sempre attiva FILE_LONG_ALIGNMENT, ma potrebbe non essere in FILE_QUAD_ALIGNMENT.

[in] MethodLength

Specifica la lunghezza indicata dal chiamante del parametro del metodo.

[in, out] Data

Specifica il parametro di dati non allineato originale.

[in] DataLength

Specifica la lunghezza indicata dal chiamante del parametro di dati.

[out] IoStatus

Specifica una struttura allineata utilizzata per restituire lo stato di errore e le informazioni.

[in] MethodSetsCount

Indica il numero di strutture del set di metodi passate.

[in] MethodSet

Specifica il puntatore all'elenco di informazioni sul set di metodi.

Valore restituito

La funzione KsFastMethodHandler restituisce TRUE se la richiesta viene gestita o FALSE se la richiesta non viene gestita. Se la richiesta non viene gestita, viene generato un IRP. Se la richiesta è stata gestita, la funzione imposta l'elemento IoStatus-Information> su zero a causa di un errore interno o l'elemento viene impostato da un gestore del metodo. Il gestore del metodo imposta anche il campo IoStatus-Status> quando il metodo viene gestito.

Commenti

Il proprietario di un set di metodi può eseguire il prefiltering o il postfiltering della gestione dei metodi usando le funzioni KsFastMethodHandler e KsMethodHandler . La funzione KsFastMethodHandler viene usata per elaborare le richieste effettuate tramite l'interfaccia di invio di I/O veloce per Device Control. Viene usato solo per elaborare le richieste che possono essere soddisfatte rapidamente. Il parametro Wait della funzione di I/O veloce non viene passato e si presuppone che sia TRUE.

Requisiti

Vedi anche

KsMethodHandler