EVT_UCX_USBDEVICE_DISABLE回呼函式 (ucxusbdevice.h)

UCX 呼叫的用戶端驅動程序實作，以釋放與裝置及其預設端點相關聯的控制器資源。

語法

EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;

void EvtUcxUsbdeviceDisable(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

參數

[in] UcxController

用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的UCX控制器句柄。

[in] Request

類型 為 USBDEVICE_DISABLE的結構。

傳回值

無

備註

UCX 用戶端驅動程式會呼叫 UcxUsbDeviceCreate 方法，向 USB 主機控制器擴充功能註冊此回呼函式， (UCX) 。

當用戶端驅動程式釋放控制器資源時，它會完成WDFREQUEST。 完成後，UCX 呼叫參考此 USB 裝置的唯一回呼函式EVT_UCX_USBDEVICE_ENABLE。

當裝置停用時，UCX 不會為其排程傳輸。

若要將裝置轉換為所需的狀態，主機控制器驅動程式會與硬體通訊以完成要求。

用戶端驅動程式會在 [要求] 中傳回完成狀態。 驅動程式可以異步完成 WDFREQUEST。

範例

VOID
UsbDevice_EvtUcxUsbDeviceDisable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)


{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

規格需求

需求	值
目標平台	Windows
最低 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	ucxusbdevice.h (包含 Ucxclass.h)
IRQL	DISPATCH_LEVEL

另請參閱

UcxUsbDeviceCreate