Functia NtFsControlFile (ntifs.h) – drivere Windows

• 30.04.2018
• 4 minute de citit

In acest articol

NtFsControlFile Rutina trimite un cod de control direct la un sistem de fisiere sau un sistem de fisiere driver de filtru specificat, provocand driverul corespunzator pentru a efectua actiunea specificata.

Sintaxa

__kernel_entry NTSYSCALLAPI NTSTATUS NtFsControlFile (HANDLE FileHandle, HANDLE Event, PIO_APC_ROUTINE ApcRoutine, PVOID ApcContext, PIO_STATUS_BLOCK IoStatusBlock, ULONG FsControlCode, PVOID InputBuff, Output PVOID

Parametrii

FileHandle

[in] Handle returnat de NtCreateFile sau NtOpenFile pentru obiectul fisier care reprezinta fisierul sau directorul pe care urmeaza sa fie efectuata actiunea specificata. Obiectul fisier trebuie sa fi fost deschis pentru I / O asincron daca apelantul specifica un eveniment , ApcRoutine si un context APC (in ApcContext ) sau un context de finalizare (in ApcContext ).

Eveniment

[in, optional] Maner pentru un eveniment creat de apelant. Daca acest parametru este furnizat, apelantul va fi pus intr-o stare de asteptare pana cand operatiunea solicitata este finalizata si evenimentul dat este setat la starea semnalata. Acest parametru este optional si poate fi NUL . Trebuie sa fie NULL daca apelantul va astepta ca FileHandle sa fie setat la starea Semnalizat.

ApcRoutine

[in, optional] Adresa unei rutine APC furnizate de apelant care va fi apelata la finalizarea operatiei solicitate. Acest parametru este optional si poate fi NUL . Trebuie sa fie NULL daca exista un obiect de completare I / O asociat cu obiectul fisier.

ApcContext

[in, optional] Pointer catre o zona contextuala determinata de apelant. Aceasta valoare a parametrului este utilizata ca context APC daca apelantul furnizeaza un APC sau este utilizata ca context de finalizare daca un obiect de completare I / O a fost asociat cu obiectul fisier. Cand operatiunea se incheie, fie contextul APC este trecut catre APC, daca a fost specificat unul, fie contextul de finalizare este inclus ca parte a mesajului de finalizare pe care Managerul I / O il posteaza la obiectul de completare I / O asociat.

Acest parametru este optional si poate fi NUL . Trebuie sa fie NULL daca ApcRoutine este NULL si nu exista niciun obiect de completare I / O asociat cu obiectul fisier.

IoStatusBlock

[out] Pointer catre o structura IO_STATUS_BLOCK care primeste starea finala finala si informatii despre operatie. Pentru apelurile de succes care returneaza date, numarul de octeti scris in OutputBuffer este returnat in membrul Informatii al acestei structuri.

FsControlCode

[in] cod FSCTL_ XXX care indica ce operatiune de control al sistemului de fisiere urmeaza sa fie efectuata. Valoarea acestui parametru determina formatele si lungimile necesare pentru InputBuffer si OutputBuffer , precum si care dintre urmatoarele perechi de parametri sunt necesare. Pentru informatii detaliate despre codurile FSCTL_ XXX definite de sistem , consultati sectiunea „Observatii” din intrarea de referinta pentru DeviceIoControl din documentatia Microsoft Windows SDK.

InputBuffer

[in, optional] Pointer catre un buffer de intrare alocat apelantului care contine informatii specifice dispozitivului pentru a fi oferite driverului tinta. Daca FsControlCode specifica o operatie care nu necesita date de intrare, acest indicator este optional si poate fi NULL .

InputBufferLength

[in] Dimensiunea, in octeti, a bufferului la InputBuffer . Aceasta valoare este ignorata daca InputBuffer este NULL .

OutputBuffer

[out, optional] Pointer catre un buffer de iesire alocat apelantului in care informatiile sunt returnate de la driverul tinta. Daca FsControlCode specifica o operatie care nu produce date de iesire, acest indicator este optional si poate fi NULL .

OutputBufferLength

[in] Dimensiunea, in octeti, a bufferului la OutputBuffer . Aceasta valoare este ignorata daca OutputBuffer este NULL .

Valoare returnata

NtFsControlFile returneaza STATUS_SUCCESS sau o valoare NTSTATUS adecvata, cum ar fi una dintre urmatoarele:

NtFsControlFile ofera o vizualizare consecventa a datelor de intrare si iesire catre sistem si catre driverele in modul kernel, oferind in acelasi timp aplicatiilor si driverelor subiacente o metoda dependenta de driver de specificare a unei interfete de comunicatii.

Daca apelantul a deschis fisierul pentru I / O asincrona (fara setul de optiuni de creare / deschidere FILE_SYNCHRONOUS_ XXX ), evenimentul specificat, daca exista, va fi setat la starea semnalizata la finalizarea operatiei de control al dispozitivului. In caz contrar, obiectul fisier specificat de FileHandle va fi setat la starea semnalizata. In cazul in care un ApcRoutine a fost specificat, este numit cu ApcContext si IoStatusBlock pointer.

Urmatoarele coduri FSCTL sunt documentate in prezent pentru driverele in modul kernel:

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_OPBATCH_ACK_CLOSE_PENDING

FSCTL_OPLOCK_BREAK_ACK_NO_2

FSCTL_OPLOCK_BREAK_ACKNOWLEDGE

FSCTL_OPLOCK_BREAK_NOTIFY

FSCTL_REQUEST_BATCH_OPLOCK

FSCTL_REQUEST_FILTER_OPLOCK

FSCTL_REQUEST_OPLOCK_LEVEL_1

FSCTL_REQUEST_OPLOCK_LEVEL_2

FSCTL_SET_REPARSE_POINT

Pentru mai multe informatii despre codurile FSCTL_ XXX definite de sistem , consultati sectiunea „Remarci” din intrarea de referinta pentru DeviceIoControl din documentatia Microsoft Windows SDK.

Pentru mai multe informatii despre definite de sistem IOCTL_ XXX coduri, precum si cu privire la definitia de conducator auto specifice IOCTL_ XXX sau FSCTL_ XXX valori, consultati Utilizarea I / Coduri O control in modul Ghid de Arhitectura Kernel si dispozitiv de intrare si iesire coduri de control in documentatia pentru Windows SDK.

Minifiltrele ar trebui sa utilizeze FltFsControlFile in loc de NtFsControlFile .

Apelantii NtFsControlFile trebuie sa ruleze la IRQL = PASSIVE_LEVEL si cu APC-uri speciale de nucleu activate.

Nota   Daca apelul catre functia NtFsControlFile apare in modul utilizator, ar trebui sa utilizati numele „ NtFsControlFile ” in loc de „ ZwFsControlFile ”.

Pentru apelurile de la driverele in modul kernel, versiunile Nt Xxx si Zw Xxx ale unei rutine Windows Native System Services se pot comporta diferit in modul in care gestioneaza si interpreteaza parametrii de intrare. Pentru mai multe informatii despre relatia dintre versiunile Nt Xxx si Zw Xxx ale unei rutine, consultati Utilizarea versiunilor Nt si Zw ale rutinelor Native System Services.

Cerinte

    Client minim acceptat Disponibil incepand cu Windows 2000. Platforma tinta Header universal ntifs.h (include Ntifs.h) Biblioteca NtosKrnl.lib DLL NtosKrnl.exe IRQL PASSIVE_LEVEL (a se vedea sectiunea Observatii) Regulile de conformitate DDI PowerIrpDDis, HwStorPortProhibitedDDIs

Vezi si

FltFsControlFile

IRP_MJ_FILE_SYSTEM_CONTROL

IoGetFunctionCodeFromCtlCode

IoIsOperationSynchronous

Utilizarea codurilor de control I / O

Utilizarea versiunilor Nt si Zw ale rutinelor Native System Services

ZwClose

ZwCreateFile

ZwDeviceIoControlFile

ZwOpenFile