funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)

  • Articolo

[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

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen