Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
I/O control codes are contained in IRP_MJ_DEVICE_CONTROL and IRP_MJ_INTERNAL_DEVICE_CONTROL requests. The I/O manager creates these requests as a result of calls to DeviceIoControl and IoBuildDeviceIoControlRequest.
Because DeviceIoControl and IoBuildDeviceIoControlRequest accept both an input buffer and an output buffer as arguments, all IRP_MJ_DEVICE_CONTROL and IRP_MJ_INTERNAL_DEVICE_CONTROL requests supply both an input buffer and an output buffer. Die Art und Weise, wie das System diese Puffer beschreibt, hängt vom Datentyp der Datenübertragung ab. The transfer type is specified by the TransferType value in the CTL_CODE macro that creates IOCTL code values.
The system describes buffers for each TransferType value as follows.
METHOD_BUFFERED
For this transfer type, IRPs supply a pointer to a buffer at Irp->AssociatedIrp.SystemBuffer. This buffer represents both the input buffer and the output buffer that are specified in calls to DeviceIoControl and IoBuildDeviceIoControlRequest. Der Treiber überträgt Daten aus diesem Puffer und dann in diesen Puffer.
For input data, the buffer size is specified by Parameters.DeviceIoControl.InputBufferLength in the driver's IO_STACK_LOCATION structure. For output data, the buffer size is specified by Parameters.DeviceIoControl.OutputBufferLength in the driver's IO_STACK_LOCATION structure.
Die Größe des Abstands, den das System für den einzelnen Eingabe-/Ausgabepuffer zuweist, ist der größere der beiden Längenwerte.
METHOD_IN_DIRECT oder METHOD_OUT_DIRECT
For these transfer types, IRPs supply a pointer to a buffer at Irp->AssociatedIrp.SystemBuffer. This represents the first buffer that is specified in calls to DeviceIoControl and IoBuildDeviceIoControlRequest. The buffer size is specified by Parameters.DeviceIoControl.InputBufferLength in the driver's IO_STACK_LOCATION structure.
For these transfer types, IRPs also supply a pointer to an MDL at Irp->MdlAddress. This represents the second buffer that is specified in calls to DeviceIoControl and IoBuildDeviceIoControlRequest. Dieser Puffer kann wie folgt als Eingabepuffer oder als Ausgabepuffer verwendet werden:
METHOD_IN_DIRECT wird angegeben, wenn der Treiber, der das IRP verarbeitet, Daten im Puffer empfängt, wenn er aufgerufen wird. Die MDL beschreibt einen Eingabepuffer und stellt METHOD_IN_DIRECT sicher, dass der ausgeführte Thread Lesezugriff auf den Puffer hat.
METHOD_OUT_DIRECT wird angegeben, wenn der Treiber, der die IRP verarbeitet, Daten in den Puffer schreibt, bevor das IRP abgeschlossen wird. Die MDL beschreibt einen Ausgabepuffer und stellt METHOD_OUT_DIRECT sicher, dass der ausgeführte Thread Schreibzugriff auf den Puffer hat.
For both of these transfer types, Parameters.DeviceIoControl.OutputBufferLength specifies the size of the buffer that is described by the MDL.
METHOD_NEITHER
Der E/A-Manager stellt keine Systempuffer oder MDLs bereit. The IRP supplies the user-mode virtual addresses of the input and output buffers that were specified to DeviceIoControl or IoBuildDeviceIoControlRequest, without validating or mapping them.
The input buffer's address is supplied by Parameters.DeviceIoControl.Type3InputBuffer in the driver's IO_STACK_LOCATION structure, and the output buffer's address is specified by Irp->UserBuffer.
Buffer sizes are supplied by Parameters.DeviceIoControl.InputBufferLength and Parameters.DeviceIoControl.OutputBufferLength in the driver's IO_STACK_LOCATION structure.
For more information about the CTL_CODE macro and the transfer types listed above, see Defining I/O Control Codes.