enumerazione WDF_IO_TARGET_OPEN_TYPE (wdfiotarget.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

L'enumerazione WDF_IO_TARGET_OPEN_TYPE specifica come un driver identifica una destinazione di I/O remota quando il driver chiama WdfIoTargetOpen.

Sintassi

typedef enum _WDF_IO_TARGET_OPEN_TYPE {
  WdfIoTargetOpenUndefined = 0,
  WdfIoTargetOpenUseExistingDevice = 1,
  WdfIoTargetOpenByName = 2,
  WdfIoTargetOpenReopen = 3,
  WdfIoTargetOpenLocalTargetByFile = 4
} WDF_IO_TARGET_OPEN_TYPE;

Costanti


`WdfIoTargetOpenUndefined` Valore: 0 Riservato per l'utilizzo nel sistema.
`WdfIoTargetOpenUseExistingDevice` Valore: 1 Questo valore è supportato solo da KMDF. Il driver identifica una destinazione di I/O remota fornendo un puntatore a una struttura di DEVICE_OBJECT di Windows Driver Model (WDM).
`WdfIoTargetOpenByName` Valore: 2 Il driver apre una destinazione di I/O remota specificando una stringa di nome Unicode che rappresenta un nome di oggetto. Questo nome può identificare un dispositivo, un file o un'interfaccia del dispositivo.
`WdfIoTargetOpenReopen` Valore: 3 Il driver riapre una destinazione di I/O remota dopo aver precedentemente chiamato WdfIoTargetCloseForQueryRemove. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
`WdfIoTargetOpenLocalTargetByFile` Valore: 4 Questo valore è supportato solo da UMDF. UMDF Il driver apre un handle di file che rappresenta lo stack inferiore (proprio come una destinazione locale), in modo che possa inviare una richiesta creata dal driver verso il basso nello stack inferiore. Un driver UMDF specifica questo valore quando chiama WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE.

Commenti

L'enumerazione WDF_IO_TARGET_OPEN_TYPE viene utilizzata nel membro Type della struttura WDF_IO_TARGET_OPEN_PARAMS.

Il driver può specificare WdfIoTargetOpenReopenReopen solo se ha specificato WdfIoTargetOpenByName quando ha aperto originariamente la destinazione di I/O remota.

Se WdfIoTargetOpenReopen è impostato, il framework ignora tutti gli altri membri della struttura WDF_IO_TARGET_OPEN_PARAMS e usa i valori specificati dal driver quando originariamente viene chiamato WdfIoTargetOpen per aprire una destinazione di I/O remota.

Per impostazione predefinita (a meno che il driver non specifichi UmdfFileObjectPolicy=AllowNullAndUnknownFileObjects nel file INF), UMDF non consente l'elaborazione di richieste di I/O non associate a un oggetto file. Inoltre, alcuni stack di driver, ad esempio PDO di raccolta enumerata HIDclass, non riescono le richieste che non hanno alcun oggetto file associato.

A differenza delle richieste create dall'app, le richieste create dal driver inviate a una destinazione di I/O locale non hanno alcun oggetto file associato. Di conseguenza, il framework o il driver inferiore potrebbe non riuscire a eseguire tali richieste.

In questo caso, è possibile usare WdfIoTargetOpenLocalTargetByFile per fare in modo che le richieste create dal driver inviate a una destinazione locale siano associate all'oggetto file corrispondente a tale destinazione.