Funzione di callback PFNKSFASTHANDLER (ks.h)

Articolo
02/07/2025

KStrFastHandler è una routine fornita dal driver che gestisce una richiesta di proprietà o metodo senza la creazione di un IRP.

Sintassi

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Parametri

[in] FileObject

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

[in] Request

Specifica il parametro della proprietà originale. Questo sarà sempre attivo FILE_LONG_ALIGNMENT, ma non può essere in FILE_QUAD_ALIGNMENT.

[in] RequestLength

Specifica la lunghezza indicata dal chiamante del parametro della proprietà.

[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. Queste informazioni vengono quindi copiate nella struttura di stato di I/O originale al completamento.

Valore restituito

KStrFastHandler restituisce true se la chiamata è stata gestita. Se la chiamata non è stata gestita, restituisce FALSE e viene generato un IRP per gestire la richiesta.

Osservazioni

Il minidriver fornisce un punto di ingresso per questa routine in KSFASTPROPERTY_ITEM o KSFASTMETHOD_ITEM.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	ks.h (include Ks.h)

Condividi tramite