EVT_UFX_DEVICE_HOST_CONNECT コールバック関数 (ufxclient.h)
ホストとの接続を開始するためのクライアント ドライバーの実装。
構文
EVT_UFX_DEVICE_HOST_CONNECT EvtUfxDeviceHostConnect;
void EvtUfxDeviceHostConnect(
[in] UFXDEVICE unnamedParam1
)
{...}
パラメーター
[in] unnamedParam1
クライアント ドライバーが UfxDeviceCreate メソッドの以前の呼び出しで受信した USB デバイス オブジェクトへのハンドル。
戻り値
なし
解説
関数ホスト コントローラーのクライアント ドライバーは、UfxDeviceCreate メソッドを呼び出して、そのEVT_UFX_DEVICE_HOST_CONNECT実装を USB 関数クラス拡張機能 (UFX) に登録します。
UFX がこのイベント コールバックを呼び出すまで、クライアント ドライバーはホストとの接続を開始しないでください。 クライアント ドライバーは、 UfxDeviceEventComplete メソッドを呼び出すことによって、このイベントの完了を示す必要があります。
例
EVT_UFX_DEVICE_HOST_CONNECT UfxDevice_EvtDeviceHostConnect;
VOID
UfxDevice_EvtDeviceHostConnect (
_In_ UFXDEVICE UfxDevice
)
/*++
Routine Description:
EvtDeviceHostConnect callback handler for UFXDEVICE object.
Arguments:
UfxDevice - UFXDEVICE object representing the device.
--*/
{
PCONTROLLER_CONTEXT ControllerContext;
PUFXDEVICE_CONTEXT DeviceContext;
BOOLEAN EventComplete;
TraceEntry();
DeviceContext = UfxDeviceGetContext(UfxDevice);
ControllerContext = DeviceGetControllerContext(DeviceContext->FdoWdfDevice);
EventComplete = TRUE;
WdfSpinLockAcquire(ControllerContext->DpcLock);
//
// #### TODO: Insert code to set the run state on the controller ####
//
WdfSpinLockRelease(ControllerContext->DpcLock);
if (EventComplete) {
UfxDeviceEventComplete(UfxDevice, STATUS_SUCCESS);
}
TraceExit();
}
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
最小 KMDF バージョン | 1.0 |
最小 UMDF バージョン | 2.0 |
Header | ufxclient.h |
IRQL | <=DISPATCH_LEVEL |