WdfPdoRequestEject 函数 （wdfpdo.h）

[仅适用于 KMDF]

WdfPdoRequestEject 方法通知框架指定设备即将从其停靠站弹出。

语法

VOID WdfPdoRequestEject(
  [in] WDFDEVICE Device
);

参数

[in] Device

表示设备的物理设备对象的框架设备对象的句柄（PDO）。

返回值

没有

注解

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

总线驱动程序可以调用 WdfPdoRequestEject 或 WdfChildListRequestChildEject 来报告驱动程序检测到尝试从设备的停靠站中弹出其中一个枚举子设备。 例如，驱动程序可能会检测到用户已按下弹出按钮。

如果设备的 PDO 的框架设备对象可用，驱动程序可以调用 WdfPdoRequestEject。 如果驱动程序正在使用动态总线枚举，并且设备的标识说明可用，驱动程序可以调用 WdfChildListRequestChildEject。

有关 WdfPdoRequestEject 和 WdfChildListRequestChildEject的详细信息，请参阅 支持弹出设备。

例子

下面的代码示例搜索子设备列表以查找与指定序列号匹配的一个设备。 当示例找到正确的子级时，它会调用 WdfPdoRequestEject 以指示子级被弹出。 此示例摘自 烤箱 示例总线驱动程序并简化。

WDFDEVICE  hChild = NULL;
NTSTATUS  status = STATUS_INVALID_PARAMETER;
PPDO_DEVICE_DATA  pdoData;

WdfFdoLockStaticChildListForIteration(Device);

while ((hChild = WdfFdoRetrieveNextStaticChild(
                                               Device, 
                                               hChild,
                                               WdfRetrieveAddedChildren
                                               )) != NULL) {
    //
    // Obtain device object context space, and check the
    // stored serial number.
    //
    pdoData = PdoGetData(hChild);
    if (SerialNo == pdoData->SerialNo) {
        status = STATUS_SUCCESS;
        WdfPdoRequestEject(hChild);
    }
}
WdfFdoUnlockStaticChildListFromIteration(Device);

要求

另请参阅

WdfFdoLockStaticChildListForIteration

WdfFdoRetrieveNextStaticChild

WdfFdoUnlockStaticChildListFromIteration