IoBuildSynchronousFsdRequest 函式 （wdm.h）
IoBuildSynchronousFsdRequest 例程會配置並設定 IRP，以供同步處理的 I/O 要求使用。
語法
__drv_aliasesMem PIRP IoBuildSynchronousFsdRequest(
[in] ULONG MajorFunction,
[in] PDEVICE_OBJECT DeviceObject,
[in, out] PVOID Buffer,
[in, optional] ULONG Length,
[in, optional] PLARGE_INTEGER StartingOffset,
[in] PKEVENT Event,
[out] PIO_STATUS_BLOCK IoStatusBlock
);
參數
[in] MajorFunction
IRP 的主要函式程序代碼。 此程式代碼可以是 IRP_MJ_PNP、IRP_MJ_READ、IRP_MJ_WRITE、IRP_MJ_FLUSH_BUFFERS或 IRP_MJ_SHUTDOWN。
[in] DeviceObject
下一個較低驅動程式裝置物件的 DEVICE_OBJECT 結構的指標，代表目標裝置。
[in, out] Buffer
數據緩衝區的指標。 如果 MajorFunction 是 IRP_MJ_WRITE，則緩衝區會包含要寫入的數據。 如果 MajorFunction 為 IRP_MJ_READ，則緩衝區會接收數據。 如果 majorFunction 為 IRP_MJ_FLUSH_BUFFERS 或 IRP_MJ_SHUTDOWN，則此參數必須 NULL。
[in, optional] Length
緩衝區所指向的長度，以位元組為單位，Buffer。 對於磁碟之類的裝置，此值必須是扇區大小的整數倍數。 從 Windows 8 開始，扇區大小可以是 4,096 或 512 個字節。 在舊版 Windows 中，扇區大小一律為 512 位元組。 讀取和寫入要求需要此參數，但排清和關機要求必須為零。
[in, optional] StartingOffset
磁碟上位移的指標，用於讀取和寫入要求。 此值的單位和意義是驅動程式特定的。 讀取和寫入要求需要此參數，但排清和關機要求必須為零。
[in] Event
呼叫端配置和初始化事件物件的指標。 當較低層級驅動程式完成要求的作業時，I/O 管理員會將事件設定為 Signaled 狀態。 呼叫 IoCallDriver之後，驅動程式可以等候事件物件。
[out] IoStatusBlock
接收較低層級驅動程式完成 IRP 時所設定之 I/O 狀態區塊的位置指標。
傳回值
如果作業成功，IoBuildSynchronousFsdRequest 會傳回已初始化 IRP 結構的指標，並從提供的參數設定下一個較低驅動程式的 I/O 堆棧位置。 否則，例程會傳回 NULL。
言論
文件系統驅動程式 （FSD） 或其他較高層級驅動程式可以呼叫 IoBuildSynchronousFsdRequest，以設定同步傳送至較低層級驅動程式的 IRP。
IoBuildSynchronousFsdRequest 配置並設定 IRP，要求較低層級的驅動程式執行同步讀取、寫入、排清或關機作業。 IRP 包含足夠的資訊來啟動作業。
較低層級的驅動程式可能會對提供給此例程的參數施加限制。 例如，磁碟驅動器可能需要針對 Length 和 StartingOffset 提供的值， 為裝置扇區大小的整數倍數。
呼叫 IoBuildSynchronousFsdRequest 以建立要求之後，驅動程式必須呼叫 IoCallDriver，以將要求傳送至下一個較低的驅動程式。 如果 IoCallDriver 傳回STATUS_PENDING，驅動程式必須藉由在指定的 事件上呼叫 KeWaitForSingleObject，等待 IRP 完成。 大部分驅動程式不需要為 IRP 設定 IoCompletion 例程。
IoBuildSynchronousFsdRequest 所建立的 IRP，必須由驅動程式呼叫 IoCompleteRequest來完成。 呼叫 IoBuildSynchronousFsdRequest 的驅動程式不得呼叫 IoFreeIrp，因為 I/O 管理員會在呼叫 ioCompleteRequest 之後釋放這些同步 IRP。
IoBuildSynchronousFsdRequest 它會建立的 IRP 排入目前線程專屬的 IRP 佇列。 如果線程結束時，I/O 管理員會取消 IRP。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI 合規性規則 | ForwardedAtBadIrqlFsdSync（wdm），HwStorPortProhibitedDDIs（storport），IoBuildSynchronousFsdRequestNoFree（wdm），IoBuildSynchronousFsdRequestWait（wdm），IoBuildSynchronousFsdRequestWaitTimeout（wdm），PowerIrpDDis（wdm），SignalEventInCompletion（wdm） |