Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Si applica solo a KMDF]
Il metodo WdfIoTargetWdmGetTargetPhysicalDevice restituisce un puntatore all'oggetto dispositivo fisico WINDOWS Driver Model (WDM) che rappresenta un dispositivo di destinazione di I/O remoto.
Sintassi
PDEVICE_OBJECT WdfIoTargetWdmGetTargetPhysicalDevice(
[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
Se la destinazione di I/O rappresenta un dispositivo PnP, WdfIoTargetWdmGetTargetPhysicalDevice restituisce un puntatore a una struttura DEVICE_OBJECT che rappresenta un PDO di destinazione I/O remoto. In caso contrario, il metodo restituisce NULL.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni:
Il puntatore restituito dal metodo di WdfIoTargetWdmGetTargetPhysicalDevice è 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 WdfIoTargetWdmGetTargetPhysicalDevice, vedere Ottenere informazioni su una destinazione I/O generale.
Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.
Esempi
L'esempio di codice seguente ottiene un puntatore a una struttura DEVICE_OBJECT che rappresenta il PDO di un dispositivo di destinazione di I/O remoto.
PDEVICE_OBJECT pTargetDO;
pTargetDO = WdfIoTargetWdmGetTargetPhysicalDevice(IoTarget);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfiotarget.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |