funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)
[Si applica a KMDF e UMDF]
La funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inizializza la struttura di WDF_IO_TARGET_OPEN_PARAMS di un driver in modo che il driver possa aprire una destinazione di I/O specificando il nome del dispositivo, del file o dell'interfaccia del dispositivo. Se il nome specificato non esiste, il sistema non tenterà di crearlo.
Sintassi
void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
[out] PWDF_IO_TARGET_OPEN_PARAMS Params,
[in] PCUNICODE_STRING TargetDeviceName,
[in] ACCESS_MASK DesiredAccess
);
Parametri
[out] Params
Puntatore a una struttura WDF_IO_TARGET_OPEN_PARAMS allocata dal driver, che la funzione inizializza.
[in] TargetDeviceName
Valore per il membro TargetDeviceName della struttura WDF_IO_TARGET_OPEN_PARAMS .
[in] DesiredAccess
Valore per il membro DesiredAccess della struttura WDF_IO_TARGET_OPEN_PARAMS .
Valore restituito
nessuno
Osservazioni
Se TargetDeviceName specifica il nome di un file già esistente, il sistema apre il file esistente. Se il file non esiste, l'operazione di apertura ha esito negativo.
La struttura WDF_IO_TARGET_OPEN_PARAMS viene usata come input per il metodo WdfIoTargetOpen .
La funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inizializza i membri Size, Type, TargetDeviceName, DesiredAccess, CreateOptions e CreateDisposition della struttura WDF_IO_TARGET_OPEN_PARAMS specificata.
KMDF La funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inizializza il membro CreateDisposition per FILE_OPEN.
UMDF La funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inizializza il membro CreateDisposition in OPEN_EXISTING.
Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.
Esempio
Per un esempio di codice che usa WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, vedere WdfIoTargetOpen.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfiotarget.h (include Wdf.h) |
| IRQL | Qualsiasi livello |
Vedi anche
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME