EVT_UFX_DEVICE_PORT_CHANGE回呼函式 (ufxclient.h)

用戶端驅動程序的實作，以更新 USB 裝置所連接之新埠的類型。

語法

EVT_UFX_DEVICE_PORT_CHANGE EvtUfxDevicePortChange;

void EvtUfxDevicePortChange(
  [in] UFXDEVICE unnamedParam1,
  [in] USBFN_PORT_TYPE unnamedParam2
)
{...}

參數

[in] unnamedParam1

用戶端驅動程式在先前呼叫 UfxDeviceCreate 中收到的USB裝置物件的句柄。

[in] unnamedParam2

指出新埠類型的USBFN_PORT_STATE型別旗標。

傳回值

無

備註

函式主機控制器的用戶端驅動程式會藉由呼叫 UfxDeviceCreate 方法，向 USB 函式類別延伸模組 (UFX) 註冊其EVT_UFX_DEVICE_PORT_CHANGE實作。

UFX 會叫用此事件回呼，以通知用戶端驅動程式有關裝置的新狀態。

用戶端驅動程式會呼叫 UfxDeviceEventComplete 方法來指出此事件的完成。

範例

EVT_UFX_DEVICE_PORT_CHANGE UfxDevice_EvtDevicePortChange;

VOID
UfxDevice_EvtDevicePortChange (
    _In_        UFXDEVICE UfxDevice,
    _In_        USBFN_PORT_TYPE NewPort
    )
/*++

Routine Description:

    EvtDevicePortChange handler for the UFXDEVICE object.
    Caches the new port type, and stops or resumes idle as needed.

Arguments:

    UfxDevice - UFXDEVICE object representing the device.

    NewPort - New port type

--*/
{
    NTSTATUS Status;
    PUFXDEVICE_CONTEXT Context;

    PAGED_CODE();

    TraceEntry();

    Context = UfxDeviceGetContext(UfxDevice);

    TraceInformation("New PORT: %d", NewPort);

    //
    //  #### TODO: Insert code to examine the device USB state and port type 
    //      and determine if it needs to stop or resume idle.


    UfxDeviceEventComplete(UfxDevice, STATUS_SUCCESS);
    TraceExit();
}

規格需求

需求	值
目標平台	Windows
最低 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	ufxclient.h
IRQL	PASSIVE_LEVEL

另請參閱

UfxDeviceCreate

UfxDeviceEventComplete