Funzione WdfIoTargetClose (wdfiotarget.h)

Articolo
02/27/2024

[Si applica a KMDF e UMDF]

Il metodo WdfIoTargetClose chiude una destinazione di I/O remota specificata.

Sintassi

void WdfIoTargetClose(
  [in] WDFIOTARGET IoTarget
);

Parametri

[in] IoTarget

Handle per un oggetto di destinazione di I/O ottenuto da una chiamata precedente a WdfIoTargetCreate.

Valore restituito

nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Dopo che un driver ha chiamato WdfIoTargetClose, può chiamare WdfIoTargetOpen per riaprire la destinazione di I/O remota.

I driver che forniscono una funzione di callback EvtIoTargetRemoveComplete devono chiamare WdfIoTargetClose dall'interno di tale funzione di callback.

Prima che il metodo WdfIoTargetClose restituisca , il framework annulla tutte le richieste di I/O della coda di destinazione.

Se un driver ha terminato di usare una destinazione di I/O remota e non userà di nuovo la destinazione e la destinazione non dispone di oggetti richiesta figlio ancora in sospeso, il driver può chiamare WdfObjectDelete senza prima chiamare WdfIoTargetClose. La chiamata a WdfObjectDelete chiude la destinazione di I/O remota, annulla tutte le richieste di I/O della coda di destinazione ed elimina l'oggetto di destinazione di I/O. Si noti che se l'oggetto padre della destinazione I/O remota è un oggetto dispositivo, il framework chiude la destinazione ed elimina l'oggetto di destinazione quando elimina l'oggetto padre. Se nella destinazione sono presenti oggetti richiesta figlio ancora in sospeso, il driver deve chiamare WdfIoTargetClose prima di poter chiamare in modo sicuro WdfObjectDelete.

Per altre informazioni su WdfIoTargetClose, vedere Controllo dello stato di una destinazione di I/O generale.

Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.

Esempio

L'esempio di codice seguente è una funzione di callback EvtIoTargetRemoveComplete che rimuove una destinazione di I/O specificata dalla raccolta di destinazioni di I/O di un driver e quindi chiude la destinazione di 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);
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfiotarget.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtIoTargetRemoveComplete

WdfIoTargetCreate

Condividi tramite