EVT_SERCX_FILEOPEN回呼函式（sercx.h）

EvtSerCerCxFileOpen 事件回呼函式會通知序列控制器驅動程式用戶端在序列控制器裝置上開啟了檔句柄，而且已建立檔案對象來代表裝置。

語法

EVT_SERCX_FILEOPEN EvtSercxFileopen;

NTSTATUS EvtSercxFileopen(
  [in] WDFDEVICE Device
)
{...}

[in] Device

代表序列控制器之架構裝置物件的WDFDEVICE句柄。

如果呼叫成功，EvtSerCxFileOpen 函式會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤狀態代碼。

序列架構延伸模組（SerCx）會呼叫此函式來準備序列控制器硬體，以接受 I/O 作業的要求。此函式應以準備好接收和傳輸數據的狀態設定控制器。如果需要中斷，此函式應該啟用中斷。此外，此函式應該只配置檔案物件存留期間所需的任何記憶體。例如，此函式可以配置中斷數據緩衝區。

若要註冊 EvtSerCxFileOpen 回呼函式，驅動程式必須呼叫 SerCxInitialize 方法。

如需詳細資訊，請參閱 Framework File Objects。

此回呼的函式類型會在 Sercx.h 中宣告，如下所示。

typedef NTSTATUS
  EVT_SERCX_FILEOPEN(
    __in WDFDEVICE Device
    );

若要定義名為 MyEvtSerCxFileOpen的 EvtSerCxFileOpen 回呼函式，您必須先提供靜態驅動程式驗證器（SDV）和其他驗證工具所需的函式宣告，如下所示。

EVT_SERCX_FILEOPEN MyEvtSerCxFileOpen;

然後，如下所示實作您的回呼函式。

NTSTATUS
  MyEvtSerCxFileOpen(
    __in WDFDEVICE Device
    )
{ ... }

如需函數宣告之 SDV 需求的詳細資訊，請參閱使用 KMDF 驅動程式的函式角色類型來宣告函式。