Función NtDeviceIoControlFile (winternl.h)
Desusado. Compila descriptores para los búferes proporcionados y pasa los datos sin tipo al controlador de dispositivo asociado al identificador de archivo. NtDeviceIoControlFile se sustituye por DeviceIoControl.
Sintaxis
__kernel_entry NTSTATUS NtDeviceIoControlFile(
[in] HANDLE FileHandle,
[in] HANDLE Event,
[in] PIO_APC_ROUTINE ApcRoutine,
[in] PVOID ApcContext,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] ULONG IoControlCode,
[in] PVOID InputBuffer,
[in] ULONG InputBufferLength,
[out] PVOID OutputBuffer,
[in] ULONG OutputBufferLength
);
Parámetros
[in] FileHandle
Abra el identificador de archivo en el archivo o dispositivo al que se debe proporcionar la información del control.
[in] Event
Identificador de un evento que se va a establecer en el signaled estado cuando se completa la operación. Este parámetro puede ser NULL.
[in] ApcRoutine
Procedimiento que se va a invocar una vez completada la operación. Este parámetro puede ser NULL. Para obtener más información sobre las llamadas a procedimientos asincrónicos (APCs), consulte Llamadas a procedimientos asincrónicos.
[in] ApcContext
Puntero que se va a pasar a ApcRoutine cuando se completa la operación. Este parámetro es necesario si se especifica una instancia de ApcRoutine .
[out] IoStatusBlock
Variable para recibir el estado de finalización final e información sobre la operación. Las llamadas de servicio que devuelven información devuelven la longitud de los datos que se escriben en el búfer de salida en el campo Información de esta variable.
[in] IoControlCode
Código que indica qué función de control de E/S de dispositivo se va a ejecutar.
[in] InputBuffer
Puntero a un búfer que contiene la información que se va a proporcionar al dispositivo de destino. Este parámetro puede ser NULL. Esta información depende del dispositivo.
[in] InputBufferLength
Longitud de InputBuffer en bytes. Si no se proporciona el búfer, se omite este valor.
[out] OutputBuffer
Puntero a un búfer que va a recibir la información de devolución dependiente del dispositivo del dispositivo de destino. Este parámetro puede ser NULL.
[in] OutputBufferLength
Longitud de OutputBuffer en bytes. Si no se proporciona el búfer, se omite este valor.
Valor devuelto
Los distintos valores NTSTATUS se definen en NTSTATUS. H, que se distribuye con el DDK de Windows.
| Código devuelto | Descripción |
|---|---|
|
La operación de control se puso en cola correctamente en el sistema de E/S. Una vez completada la operación, el estado se puede determinar examinando el campo Estado del bloque de estado de E/S. |
Comentarios
El servicio NtDeviceIoControlFile es una interfaz dependiente del dispositivo que extiende el control que las aplicaciones tienen sobre varios dispositivos del sistema. Esta API proporciona una vista coherente de los datos de entrada y salida al sistema, a la vez que proporciona la aplicación y el controlador un método dependiente del dispositivo para especificar una interfaz de comunicaciones.
El tipo de acceso al archivo que necesita el autor de la llamada depende de la operación real que se realiza.
Una vez completado el servicio, el evento, si se especifica, se establece en el signaled estado . Si no se especifica ningún parámetro Event , el objeto de archivo especificado por FileHandle se establece en el signaled estado . Si se especifica una instancia de ApcRoutine , se invoca con ApcContext y IoStatusBlock como argumentos.
Dado que no hay ninguna biblioteca de importación para esta función, debe usar GetProcAddress.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winternl.h |
| Library | ntdll.lib |
| Archivo DLL | ntdll.dll |