Funzione WdfIoTargetWdmGetTargetFileObject (wdfiotarget.h)

[Si applica solo a KMDF]

Il metodo WdfIoTargetWdmGetTargetFileObject restituisce un puntatore all'oggetto file wdM (Windows Driver Model) associato a una destinazione di I/O remota specificata.

Sintassi

PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
  [in] WDFIOTARGET IoTarget
);

Parametri

[in] IoTarget

Handle per un oggetto di destinazione di I/O remoto. Questo handle è stato ottenuto da una chiamata precedente a WdfIoTargetCreate.

Valore restituito

WdfIoTargetWdmGetTargetFileObject restituisce un puntatore a una struttura di FILE_OBJECT WDM.

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

Osservazioni:

Il puntatore restituito dal metodo WdfIoTargetWdmGetTargetFileObject è valido fino a quando il driver non chiama WdfIoTargetClose o WdfIoTargetCloseForQueryRemoveo fino all'eliminazione dell'oggetto di destinazione I/O remoto. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto di destinazione I/O remoto e se l'oggetto viene eliminato prima della chiusura della destinazione di I/O remota, il puntatore è valido fino a quando non viene restituita la funzione EvtCleanupCallback.

Se il driver tenta di accedere all'oggetto dispositivo WDM dopo che è stato rimosso, il driver può causare l'arresto anomalo del sistema. L'esempio toastmon illustra come il driver può fornire un EvtIoTargetQueryRemove funzione di callback in modo che venga notificata se la destinazione di I/O viene rimossa.

Per altre informazioni su WdfIoTargetWdmGetTargetFileObject, vedere Ottenere informazioni su una destinazione di I/O generale.

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

Esempi

Nell'esempio di codice seguente viene ottenuto un puntatore all'oggetto file WDM associato a una destinazione di I/O remota.

PFILE_OBJECT pfileObject;

pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);

Requisiti

Vedere anche

FILE_OBJECT

WdfIoTargetCreare

WdfIoTargetWdmGetTargetDeviceObject

WdfIoTargetWdmGetTargetFileHandle