SerCx2PioReceiveCreate 函式（sercx.h）

發行項
10/30/2024

SerCx2PioReceiveCreate 方法會建立 PIO 接收物件，這是序列架構延伸模組（SerCx2）第 2 版用來執行 PIO 接收交易。

語法

NTSTATUS SerCx2PioReceiveCreate(
  [in]           WDFDEVICE                  Device,
  [in]           PSERCX2_PIO_RECEIVE_CONFIG PioReceiveConfig,
  [in, optional] PWDF_OBJECT_ATTRIBUTES     Attributes,
  [out]          SERCX2PIORECEIVE           *PioReceive
);

參數

[in] Device

代表序列控制器之架構裝置物件的WDFDEVICE句柄。序列控制器驅動程式會在其 EvtDriverDeviceAdd 回呼函式中建立這個物件。如需詳細資訊，請參閱 SerCx2InitializeDevice。

[in] PioReceiveConfig

SERCX2_PIO_RECEIVE_CONFIG 結構的指標。呼叫此方法之前，呼叫端必須呼叫 SERCX2_PIO_RECEIVE_CONFIG_INIT 函式來初始化結構。此結構包含序列控制器驅動程式所實作之一組事件回呼例程的指標。 SerCx2 會呼叫這些函式來執行 PIO 接收交易。

[in, optional] Attributes

WDF_OBJECT_ATTRIBUTES 結構的指標，描述要指派給新 PIO 接收對象的屬性。呼叫此方法之前，呼叫端必須呼叫 WDF_OBJECT_ATTRIBUTES_INIT 函式來初始化結構。此參數是選擇性的，如果序列控制器驅動程式不需要將屬性指派給物件，則可以指定為WDF_NO_OBJECT_ATTRIBUTES。如需詳細資訊，請參閱。

[out] PioReceive

這個方法將 SERCX2PIORECEIVE 句柄寫入新建立之 PIO-receive 物件的位置指標。 SerCx2 和序列控制器驅動程式會在後續呼叫中使用這個句柄來參考這個物件。

傳回值

如果呼叫成功，這個方法會傳回STATUS_SUCCESS。可能的錯誤傳回值包括下列狀態代碼。

傳回碼	描述
STATUS_INVALID_DEVICE_REQUEST	PIO 接收物件已存在於先前 SerCx2PioReceiveCreate 呼叫中。
STATUS_INFO_LENGTH_MISMATCH	ConfigSize 值不等於sizeofSERCX2_PIO_RECEIVE_CONFIG。
STATUS_INVALID_PARAMETER	實作回呼函式的指定組合無效。驅動程式必須實作 EvtSerCx2PioReceiveReadBuffer、EvtSerCx2PioReceiveEnableReadyNotification和 EvtSerCx2PioReceiveCancelReadyNotification 函式。
STATUS_INSUFFICIENT_RESOURCES	資源不足，無法執行要求的作業。