KsQueryInformationFile, fonction (ks.h)
La fonction KsQueryInformationFile effectue une requête d’informations sur l’objet de fichier spécifié. La fonction tente d’utiliser FastIoDispatch si possible, ou génère une demande d’informations sur l’objet d’appareil.
KSDDKAPI NTSTATUS KsQueryInformationFile(
[in] PFILE_OBJECT FileObject,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
[in] FileObject
Spécifie l’objet de fichier à partir duquel interroger les informations standard.
[out] FileInformation
Indique l’emplacement dans lequel placer les informations de fichier. Il s’agit d’une adresse valide ou sondée.
[in] Length
Spécifie la longueur correcte de la mémoire tampon FileInformation .
[in] FileInformationClass
Spécifie la classe d’informations demandée.
La fonction KsQueryInformationFile retourne STATUS_SUCCESS en cas de réussite, ou en cas d’échec, elle retourne une erreur de requête.
La fonction KsQueryInformationFile ne doit être utilisée que dans les cas où la requête entraînerait une requête réelle au pilote sous-jacent. Par exemple, FilePositionInformation ne génère pas une telle demande et ne doit pas être utilisé. Il suppose que l’appelant sérialise l’accès au fichier pour les opérations sur un objet de fichier FO_SYNCHRONOUS_IO.
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
En-tête | ks.h (inclure Ks.h) |
Bibliothèque | Ks.lib |