EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL回呼函式 (wdfio.h)

發行項
02/27/2024

[適用於 KMDF 和 UMDF]

驅動程式的 EvtIoInternalDeviceControl 事件回呼函式會處理 I/O 要求，其中包含內部裝置 I/O 控制程式碼 (IOCTL) 。

語法

EVT_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL EvtWdfIoQueueIoInternalDeviceControl;

void EvtWdfIoQueueIoInternalDeviceControl(
  [in] WDFQUEUE Queue,
  [in] WDFREQUEST Request,
  [in] size_t OutputBufferLength,
  [in] size_t InputBufferLength,
  [in] ULONG IoControlCode
)
{...}

參數

[in] Queue

與 I/O 要求相關聯的架構佇列物件的句柄。

[in] Request

架構要求物件的句柄。

[in] OutputBufferLength

如果可用的輸出緩衝區，則為要求的輸出緩衝區長度，以位元組為單位。

[in] InputBufferLength

如果輸入緩衝區可用，則為要求的輸入緩衝區長度，以位元組為單位。

[in] IoControlCode

與要求相關聯的驅動程式定義或系統定義的IOCTL。

傳回值

無

備註

驅動程式會在呼叫 WdfIoQueueCreate 方法時註冊 EvtIoInternalDeviceControl 回呼函式。如需呼叫 WdfIoQueueCreate 的詳細資訊，請參閱建立 I/O 佇列。

如果驅動程式已註冊裝置 I/O 佇列的 EvtIoInternalDeviceControl 回呼函式，則回呼函式會從佇列接收每個內部 I/O 控制要求 (IRP_MJ_INTERNAL_DEVICE_CONTROL) 。如需詳細資訊，請參閱要求處理程式。

EvtIoInternalDeviceControl 回呼函式必須以某種方式處理每個收到的 I/O 要求。如需詳細資訊，請參閱處理 I/O 要求。

當另一個驅動程式呼叫 WdfIoTargetSendInternalIoctlSynchronously 或 WdfIoTargetFormatRequestForInternalIoctl 來建立要求時，驅動程式會收到內部 I/O 控制要求。

要執行的作業類型取決於 IoControlCode 參數的值。您必須判斷應用程式和其他驅動程式可以傳送給驅動程式的 IoControlCode 值集。如需IOCTL的詳細資訊，請參閱使用I/O控件代碼。

大部分的內部 I/O 控制作業都需要輸入緩衝區、輸出緩衝區或兩者。如需驅動程式如何存取要求緩衝區的資訊，請參閱存取 Framework-Based 驅動程式中的數據緩衝區。

驅動程式可用來存取要求輸入和輸出緩衝區的技術，如果它們存在) 則 (視 IOCTL 的 TransferType 欄位而定。 IOCTL 的 TransferType 欄位的值可以是METHOD_BUFFERED、METHOD_DIRECT_IN、METHOD_DIRECT_OUT或METHOD_NEITHER。如需 TransferType 字段的詳細資訊，請參閱定義 I/O 控件代碼。

除非裝置或驅動程式WDF_OBJECT_ATTRIBUTES結構的ExecutionLevel 成員設定為 WdfExecutionLevelPassive，否則可以在 IRQL <= DISPATCH_LEVEL呼叫 EvtIoInternalDeviceControl 回呼函式。 (如果您的驅動程式位於其驅動程式堆疊頂端，則會在 IRQL = PASSIVE_LEVEL.) 呼叫回呼函式

如果 IRQL PASSIVE_LEVEL，架構會呼叫重要區域內的回呼函式。

如需要求處理程式 IRQL 層級的詳細資訊，請參閱使用自動同步處理。

驅動程式的 EvtIoInternalDeviceControl 回呼函式不應該呼叫下列佇列物件方法：

WdfIoQueueDrainSynchronously

WdfIoQueuePurgeSynchronously

WdfIoQueueStopSynchronously