Funzione KsQueryInformationFile (ks.h)

La funzione KsQueryInformationFile esegue una query di informazioni sull'oggetto file specificato. Se possibile, la funzione tenta di usare FastIoDispatch oppure genera una richiesta di informazioni sull'oggetto dispositivo.

Sintassi

KSDDKAPI NTSTATUS KsQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Parametri

[in] FileObject

Specifica l'oggetto file da cui eseguire query sulle informazioni standard.

[out] FileInformation

Indica la posizione in cui inserire le informazioni sul file. Si presuppone che sia un indirizzo valido o probe.

[in] Length

Specifica la lunghezza corretta del buffer FileInformation .

[in] FileInformationClass

Specifica la classe di informazioni richieste.

Valore restituito

La funzione KsQueryInformationFile restituisce STATUS_SUCCESS se ha esito positivo o se ha esito negativo restituisce un errore di query.

Commenti

La funzione KsQueryInformationFile deve essere usata solo nei casi in cui la query genera una richiesta effettiva al driver sottostante. Ad esempio, FilePositionInformation non genera tale richiesta e non deve essere usata. Presuppone che il chiamante serializzi l'accesso al file per le operazioni su un oggetto file FO_SYNCHRONOUS_IO.

Requisiti