Funzione KsFastPropertyHandler (ks.h)

La funzione KsFastPropertyHandler gestisce le richieste di proprietà veloci tramite IOCTL_KS_PROPERTY. Risponde a tutti gli identificatori di proprietà definiti dai set contenuti anche nell'elenco di I/O veloce. Questa funzione può essere chiamata solo in PASSIVE_LEVEL.

Sintassi

KSDDKAPI BOOLEAN KsFastPropertyHandler(
  PFILE_OBJECT         FileObject,
  PKSPROPERTY          Property,
  ULONG                PropertyLength,
  PVOID                Data,
  ULONG                DataLength,
  PIO_STATUS_BLOCK     IoStatus,
  ULONG                PropertySetsCount,
  const KSPROPERTY_SET *PropertySet
);

Parametri

FileObject

Property

PropertyLength

Data

DataLength

IoStatus

PropertySetsCount

PropertySet

Valore restituito

La funzione KsFastPropertyHandler restituisce TRUE se la richiesta è stata gestita o FALSE se la richiesta non è stata gestita. Se viene restituito FALSE , viene generato un IRP. Se la richiesta è stata gestita, la funzione imposta l'elemento IoStatus-Information>, impostandolo su zero a causa di un errore interno o impostandolo tramite un gestore di proprietà. Il gestore della proprietà imposta anche il campo IoStatus-Status> quando la proprietà viene effettivamente gestita.

Commenti

Il proprietario di un set di proprietà può eseguire il prefiltering o il postfiltering della gestione delle proprietà, nonché l'elaborazione delle richieste effettuate tramite l'interfaccia di invio di I/O veloce per il controllo del dispositivo. La funzione KsFastPropertyHandler viene usata 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

KsPropertyHandler