WdfIoTargetClose 函式 (wdfiotarget.h)

[適用於 KMDF 和 UMDF]

WdfIoTargetClose 方法會關閉指定的遠端 I/O 目標。

語法

void WdfIoTargetClose(
  [in] WDFIOTARGET IoTarget
);

參數

[in] IoTarget

從先前呼叫 WdfIoTargetCreate 取得的 I/O 目標物件的句柄。

傳回值

無

備註

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

驅動程式呼叫 WdfIoTargetClose 之後，可以呼叫 WdfIoTargetOpen 重新開啟遠端 I/O 目標。

提供 EvtIoTargetRemoveComplete 回調函式的驅動程式必須從該回呼函式內呼叫 WdfIoTargetClose 。

在 WdfIoTargetClose 方法傳回之前，架構會取消所有目標佇列的 I/O 要求。

如果驅動程式已使用遠端 I/O 目標完成，且不會再次使用目標，而且目標沒有仍然擱置的子要求物件，則驅動程式可以呼叫 WdfObjectDelete ，而不需要先呼叫 WdfIoTargetClose。 對 WdfObjectDelete 的呼叫將會關閉遠端 I/O 目標、取消所有目標佇列的 I/O 要求，並刪除 I/O 目標物件。 (請注意，如果遠端 I/O 目標的父對像是裝置對象，架構就會關閉目標，並在刪除父物件時刪除目標物件。) 如果目標有任何子要求物件仍在擱置中，驅動程式必須先呼叫 WdfIoTargetClose ，才能安全地呼叫 WdfObjectDelete。

如需 WdfIoTargetClose 的詳細資訊，請參閱 控制一般 I/O 目標的狀態。

如需 I/O 目標的詳細資訊，請參閱 使用 I/O 目標。

範例

下列程式代碼範例是 EvtIoTargetRemoveComplete 回 呼函式，它會從驅動程式的 I/O 目標集合中移除指定的 I/O 目標，然後關閉 I/O 目標。

VOID
MyEvtIoTargetRemoveComplete(
    WDFIOTARGET IoTarget
)
{
    //
    // Get device information from the I/O target object's
    // context space.
    //
    targetDeviceInfo = GetTargetDeviceInfo(IoTarget);
    deviceExtension = targetDeviceInfo->DeviceExtension;

    //
    // Remove the target device from the collection.
    //
    WdfWaitLockAcquire(
                       deviceExtension->TargetDeviceCollectionLock,
                       NULL
                       );

    WdfCollectionRemove(
                        deviceExtension->TargetDeviceCollection,
                        IoTarget
                        );

    WdfWaitLockRelease(deviceExtension->TargetDeviceCollectionLock);

    //
    // Close the target.
    //
    WdfIoTargetClose(IoTarget);
}

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.0
最低UMDF版本	2.0
標頭	wdfiotarget.h (包含 Wdf.h)
程式庫	Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI 合規性規則	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

EvtIoTargetRemoveComplete

WdfIoTargetCreate