Funzione KsSetInformationFile (ks.h)

La funzione KsSetInformationFile esegue un set di informazioni sull'oggetto file specificato. La funzione tenta di usare FastIoDispatch, se possibile, oppure genera un set di informazioni sull'oggetto dispositivo.

Sintassi

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

Parametri

[in] FileObject

Specifica l'oggetto file su cui impostare le informazioni standard.

[in] FileInformation

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

[in] Length

Specifica la lunghezza corretta del buffer di FileInformation.

[in] FileInformationClass

Specifica la classe di informazioni impostate.

Valore restituito

La funzione KsSetInformationFile restituisce STATUS_SUCCESS in caso di esito positivo o se ha esito negativo restituisce un errore impostato.

Osservazioni

Il funzione KsSetInformationFile deve essere usata solo quando il set genera una richiesta effettiva al driver sottostante, senza includere operazioni complesse che richiedono parametri aggiuntivi da inviare al driver, ad esempio rinomina, eliminazione e completamento. 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.

Fabbisogno