SerCx2 物件控制碼
本主題描述針對序列架構延伸模組第 2 版所特別定義的物件控制碼類型， (SerCx2) 。
SerCx2 裝置驅動程式介面 (DDI) 使用這些控制碼類型來參考具有 SerCx2 特有的特性和功能的物件。
此外，SerCx2 DDI 會使用由 Kernel-Mode Driver Framework (KMDF) 定義的一般物件控制碼類型 WDFDEVICE 和 WDFREQUEST。
如需架構控制碼類型的詳細資訊，請參閱 Framework 物件的摘要。
本主題描述下列物件控制碼：
- SERCX2CUSTOMRECEIVE 物件控制碼
- SERCX2CUSTOMRECEIVETRANSACTION 物件控制碼
- SERCX2CUSTOMTRANSMIT 物件控制碼
- SERCX2CUSTOMTRANSMITTRANSACTION 物件控制碼
- SERCX2PIORECEIVE 物件控制碼
- SERCX2PIOTRANSMIT 物件控制碼
- SERCX2SYSTEMDMARECEIVE 物件控制碼
- SERCX2SYSTEMDMATRANSMIT 物件控制碼
標頭：2.0\Sercx.h
SERCX2CUSTOMRECEIVE 物件控制碼
SERCX2CUSTOMRECEIVE物件控制碼是序列架構延伸模組第 2 版中自訂接收物件的不透明參考， (SerCx2) 。
SerCx2CustomReceiveCreate方法會建立自訂接收物件。 SerCx2 使用此物件來管理使用自訂資料傳輸機制從序列控制器讀取資料的 I/O 交易。 此物件對序列控制器驅動程式不透明。
SerCx2CustomReceiveCreate 會以輸出參數的形式提供 SERCX2CUSTOMRECEIVE 控制碼給新建立的自訂接收物件。
SerCx2 和序列控制器驅動程式會使用此控制碼，在後續呼叫 SerCx2 方法和事件回呼函式中參考 物件。
SerCx2CustomReceiveCreate建立自訂接收物件之後，此物件會存在於代表序列控制器裝置的架構裝置物件存留期。 刪除裝置物件時，會自動刪除自訂接收物件。 序列控制器驅動程式 不得 嘗試藉由呼叫 WdfObjectDelete之類的方法來刪除自訂接收物件。
序列控制器驅動程式可以做為選項來建立自訂接收物件，但可以建立一個以上的這類物件。
驅動程式只能在下列情況下建立此物件：
- 驅動程式先前已建立 PIO-receive 物件。
- 驅動程式 尚未 建立 system-DMA-receive 物件。
如需 PIO 接收物件的詳細資訊，請參閱 SERCX2PIORECEIVE 物件控制碼。
如需 system-DMA-receive 物件的詳細資訊，請參閱 SERCX2SYSTEMDMARECEIVE 物件控制碼。
SERCX2CUSTOMRECEIVETRANSACTION 物件控制碼
SERCX2CUSTOMRECEIVETRANSACTION物件控制碼是序列架構延伸模組第 2 版中自訂接收交易對象的不透明參考， (SerCx2) 。
SerCx2CustomReceiveTransactionCreate方法會建立 custom-receive-transaction 物件。 SerCx2 會使用此物件來管理使用自訂資料傳輸機制來讀取序列控制器所接收資料的 I/O 交易。
此物件對序列控制器驅動程式不透明。
SerCx2CustomReceiveTransactionCreate 提供作為輸出參數的 SERCX2CUSTOMRECEIVETRANSACTION 控制碼，提供給新建立的 custom-receive-transaction 物件。
SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續自訂接收交易中的 物件。
如需詳細資訊，請參閱 SerCx2 Custom-Receive Transactions。
SerCx2CustomReceiveTransactionCreate建立 custom-receive-transaction 物件之後，此物件存在於代表序列控制器裝置之架構裝置物件的存留期。
刪除裝置物件時，會自動刪除 custom-receive-transaction 物件。
序列控制器驅動程式 不得 嘗試藉由呼叫 WdfObjectDelete之類的方法來刪除 custom-receive-transaction 物件。
序列控制器驅動程式可以做為選項來建立自訂接收交易對象，但可以建立一個以上的這類物件。
驅動程式只能在下列情況下建立此物件： < /wdcml：p>
- 驅動程式先前已建立 PIO-receive 物件。
- 驅動程式先前已建立自訂接收物件。
如需 PIO 接收物件的詳細資訊，請參閱 SERCX2PIORECEIVE 物件控制碼。 如需自訂接收物件的詳細資訊，請參閱 SERCX2CUSTOMRECEIVE 物件控制碼。
雖然自訂接收和自訂接收交易對象的相似存留期，但這些物件類型會定義為個別的物件類型 (，而且不會合並成一種類型) ，以支援 SerCx2 裝置驅動程式介面未來可能的擴充。
SERCX2CUSTOMTRANSMIT 物件控制碼
SERCX2CUSTOMTRANSMIT 物件控制碼是串列架構延伸模組第 2 版中自訂傳輸物件的不透明參考， (SerCx2) 。
SerCx2CustomTransmitCreate方法會建立自訂傳輸物件.h SerCx2 使用此物件來管理將資料寫入序列控制器的 I/O 交易。 此物件對序列控制器驅動程式不透明。
SerCx2CustomTransmitCreate 提供作為輸出參數的 SERCX2CUSTOMTRANSMIT 控制碼，提供給新建立的自訂傳輸物件。 SerCx2 和序列控制器驅動程式會使用此控制碼，在後續呼叫 SerCx2 方法和事件回呼函式中參考 物件。
SerCx2CustomTransmitCreate建立自訂傳輸物件之後，此物件會存在於代表序列控制器裝置的架構裝置物件存留期。
刪除裝置物件時，會自動刪除自訂傳輸物件。 序列控制器驅動程式 不得 嘗試藉由呼叫 WdfObjectDelete之類的方法來刪除自訂傳輸物件。
序列控制器驅動程式可以做為選項來建立自訂傳輸物件，但可以建立一個以上的這類物件。
驅動程式只能在下列情況下建立此物件：
- 驅動程式先前已建立 PIO 傳輸物件。
- 驅動程式 尚未 建立 system-DMA-transmit 物件。
如需 PIO 傳輸物件的詳細資訊，請參閱 SERCX2PIOTRANSMIT 物件控制碼。 如需 system-DMA-transmit 物件的詳細資訊，請參閱 SERCX2SYSTEMDMATRANSMIT 物件控制碼。
SERCX2CUSTOMTRANSMITTRANSACTION 物件控制碼
SERCX2CUSTOMTRANSMITTRANSACTION 物件控制碼是串列架構延伸模組第 2 版中自訂傳輸交易對象的不透明參考， (SerCx2) 。
SerCx2CustomTransmitTransactionCreate方法會建立自訂傳輸交易對象。 SerCx2 會使用此物件來管理使用自訂資料傳輸機制將資料寫入序列控制器的 I/O 交易。 此物件對序列控制器驅動程式不透明。
SerCx2CustomTransmitTransactionCreate 提供作為輸出參數的 SERCX2CUSTOMTRANSMITTRANSACTION 控制碼，提供給新建立的自訂傳輸交易對象。 SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續自訂傳輸交易中的 物件。
如需詳細資訊，請參閱 SerCx2 Custom-Transmit Transactions。
SerCx2CustomTransmitTransactionCreate建立 custom-transmit-transaction 物件之後，此物件會存在於代表序列控制器裝置之架構裝置物件的存留期。 刪除裝置物件時，會自動刪除自訂傳輸交易對象。 序列控制器驅動程式 不得 嘗試藉由呼叫 WdfObjectDelete之類的方法來刪除 custom-transmit-transaction 物件。
序列控制器驅動程式可以做為選項來建立自訂傳輸物件，但可以建立一個以上的這類物件。 驅動程式只能在下列情況下建立此物件：
- 驅動程式先前已建立 PIO 傳輸物件。
- 驅動程式 尚未 建立 system-DMA-transmit 物件。
如需 PIO 傳輸物件的詳細資訊，請參閱 SERCX2PIOTRANSMIT 物件控制碼。 如需自訂傳輸物件的詳細資訊，請參閱 SERCX2CUSTOMTRANSMIT 物件控制碼。
雖然自訂傳輸和自訂傳輸交易對象的相似存留期，但這些物件類型會定義為個別的物件類型 (，而且不會合並成一種類型) ，以支援 SerCx2 裝置驅動程式介面未來可能的擴充。
SERCX2PIORECEIVE 物件控制碼
SERCX2PIORECEIVE 物件控制碼是序列架構延伸模組第 2 版中 PIO 接收物件的不透明參考， (SerCx2) 。
SerCx2PioReceiveCreate方法會建立 PIO-receive 物件。 SerCx2 會使用 物件來管理程式化 I/O (PIO) 從序列控制器讀取資料的交易。 此物件對序列控制器驅動程式不透明。 提供新建立之 PIO 接收物件的 SERCX2PIORECEIVE 控制碼作為輸出參數。 SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續 PIO 接收交易中的物件。
如需詳細資訊，請參閱 SerCx2 PIO-Receive Transactions。 SerCx2PioReceiveCreate建立 PIO-receive 物件之後，此物件會存在於代表序列控制器裝置的架構裝置物件存留期。 刪除裝置物件時，會自動刪除 PIO-receive 物件。 序列控制器驅動程式 不得 嘗試藉由呼叫 WdfObjectDelete之類的方法來刪除 PIO 接收物件。
序列控制器驅動程式必須建立一個 PIO 接收物件，而且只能建立一個 PIO 接收物件。 驅動程式必須先建立這個物件，才能建立 system-DMA-receive 物件或自訂接收物件。 如需 system-DMA-receive 物件的詳細資訊，請參閱 SERCX2SYSTEMDMARECEIVE 物件控制碼。 如需自訂接收物件的詳細資訊，請參閱 SERCX2CUSTOMRECEIVE 物件控制碼。
SERCX2PIOTRANSMIT 物件控制碼
SERCX2PIOTRANSMIT 物件控制碼是序列架構延伸模組第 2 版中 PIO 傳輸物件的不透明參考， (SerCx2) 。
SerCx2PioTransmitCreate方法會建立 PIO 傳輸物件。 SerCx2 會使用此物件來管理使用程式化 I/O (PIO) 將資料寫入序列控制器的 I/O 交易。 此物件對序列控制器驅動程式不透明。 SerCx2PioTransmitCreate 提供作為輸出參數的 SERCX2PIOTRANSMIT 控制碼給新建立的 PIO 傳輸物件。 SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續 PIO 傳輸交易中的物件。 如需詳細資訊，請參閱 SerCx2 PIO-Transmit Transactions。 在 SerCx2PioTransmitCreate 建立 PIO 傳輸物件之後，此物件存在於代表序列控制器裝置之架構裝置物件的存留期。 刪除裝置物件時，會自動刪除 PIO 傳輸物件。 序列控制器驅動程式 不得 藉由呼叫 WdfObjectDelete之類的方法來嘗試刪除 PIO 傳輸物件。
序列控制器驅動程式必須建立一個且只有一個 PIO 傳輸物件。 驅動程式必須先建立這個物件，才能建立 system-DMA-transmit 物件或自訂傳輸物件。 如需 system-DMA-transmit 物件的詳細資訊，請參閱 SERCX2SYSTEMDMATRANSMIT 物件控制碼。 如需自訂傳輸物件的詳細資訊，請參閱 SERCX2CUSTOMTRANSMIT 物件控制碼。
SERCX2SYSTEMDMARECEIVE 物件控制碼
SERCX2SYSTEMDMARECEIVE 物件控制碼是序列架構延伸模組第 2 版中 system-DMA-receive 物件的不透明參考， (SerCx2) 。
SerCx2SystemDmaReceiveCreate方法會建立 system-DMA-receive 物件。 SerCx2 會使用此物件來管理從序列控制器讀取資料的系統 DMA 交易。 此物件對序列控制器驅動程式不透明。 SerCx2SystemDmaReceiveCreate 會以輸出參數的形式提供 SERCX2SYSTEMDMARECEIVE 控制碼給新建立的系統-DMA-receive 物件。 SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續 system-DMA-receive 交易中的物件。 如需詳細資訊，請參閱 SerCx2 System-DMA-Receive Transactions。
在 SerCx2SystemDmaReceiveCreate建立 system-DMA-receive 物件之後，此物件存在於代表序列控制器裝置之架構裝置物件的存留期。 刪除裝置物件時，系統-DMA-receive 物件會自動刪除。 序列控制器驅動程式可以選擇建立 system-DMA-receive 物件，但可以建立不超過一個這類物件。 驅動程式只能在下列情況下建立此物件：
- 驅動程式先前已建立 PIO-receive 物件。
- 驅動程式 尚未 建立自訂接收物件。
如需 PIO 接收物件的詳細資訊，請參閱 SERCX2PIORECEIVE 物件控制碼。 如需自訂接收物件的詳細資訊，請參閱 SERCX2CUSTOMRECEIVE 物件控制碼。
SERCX2SYSTEMDMATRANSMIT 物件控制碼
SERCX2SYSTEMDMATRANSMIT 物件控制碼是序列架構延伸模組第 2 版中 system-DMA-transmit 物件的不透明參考， (SerCx2) 。
SerCx2SystemDmaTransmitCreate方法會建立 system-DMA-transmit 物件。 SerCx2 會使用此物件來管理將資料寫入序列控制器的系統 DMA 交易。 此物件對序列控制器驅動程式不透明。 SerCx2SystemDmaTransmitCreate 提供作為輸出參數的 SERCX2SYSTEMDMATRANSMIT 控制碼給新建立的 system-DMA-transmit 物件。 SerCx2 和序列控制器驅動程式會使用此控制碼來參考後續系統 DMA 傳輸交易中的物件。 如需詳細資訊，請參閱 SerCx2 System-DMA-Transmit Transactions。
在 SerCx2SystemDmaTransmitCreate建立 system-DMA-transmit 物件之後，此物件存在於代表序列控制器裝置之架構裝置物件的存留期。 刪除裝置物件時，系統-DMA-transmit 物件會自動刪除。 序列控制器驅動程式 不得 藉由呼叫 WdfObjectDelete之類的方法來嘗試刪除 system-DMA-transmit 物件。
序列控制器驅動程式可以選擇建立 system-DMA-transmit 物件，但可以建立不超過一個這類物件。 驅動程式只能在下列情況下建立此物件： < /wdcml：p>
- 驅動程式先前已建立 PIO 傳輸物件。
- 驅動程式 尚未 建立自訂傳輸物件。
如需 PIO 傳輸物件的詳細資訊，請參閱 SERCX2PIOTRANSMIT 物件控制碼。 如需自訂傳輸物件的詳細資訊，請參閱 SERCX2CUSTOMTRANSMIT 物件控制碼。
相關主題
SerCx2 System-DMA-Receive Transactions
SerCx2 System-DMA-Transmit Transactions
SerCx2CustomReceiveTransactionCreate
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應