Metodo IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo GetCreateParametersEx recupera i parametri di creazione di file associati a un file che viene creato o aperto.
Sintassi
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
Parametri
[out, optional] pOptions
Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano le opzioni di creazione del file. Questi flag di bit denominati FILE_XXXX sono definiti in Wdm.h.
I 24 bit bassi della variabile indicano le opzioni da applicare durante la creazione o l'apertura del file. Per altre informazioni su questi bit, vedere la descrizione del parametro CreateOptions della funzione ZwCreateFile.
Gli otto bit alti della variabile indicano azioni da eseguire se il file non esiste o non esiste già. Per altre informazioni su questi bit, vedere la descrizione del parametro CreateDisposition di ZwCreateFile.
Questo parametro è facoltativo e può essere NULL.
[out, optional] pFileAttributes
Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano gli attributi del file. Questi flag di bit denominati FILE_ATTRIBUTE_XXXX sono definiti in Wdm.h. Per altre informazioni su questi flag di bit, vedere la descrizione del parametro FileAttributes di ZwCreateFile.
Questo parametro è facoltativo e può essere NULL.
[out, optional] pShareAccess
Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano le opzioni di condivisione file. Questi flag di bit denominati FILE_SHARE_XXXX sono definiti in Wdm.h. Per altre informazioni su questi flag di bit, vedere la descrizione del parametro ShareAccess di ZwCreateFile.
Questo parametro è facoltativo e può essere NULL.
[out, optional] pDesiredAccess
Puntatore a una struttura ACCESS_MASK allocata dal chiamante che specifica l'accesso richiesto al file. Per altre informazioni su questo parametro, vedere il parametro DesiredAccess di ZwCreateFile.
Questo parametro è facoltativo e può essere NULL.
Valore restituito
Nessuno
Osservazioni
Dopo che il framework chiama la funzione di callback di un driver IQueueCallbackCreate::OnCreateFile, il driver può chiamare il metodo IWDFIoRequest::GetCreateParameters o il metodo IWDFIoRequest2::GetCreateParametersEx per ottenere i parametri di creazione del file.
Per altre informazioni, vedere ottenere parametri per le richieste di I/O.
Esempi
Nell'esempio di codice seguente viene illustrato come una funzione di callback IQueueCallbackCreate::OnCreateFile può ottenere l'interfaccia IWDFIoRequest2 e quindi chiamare GetCreateParametersEx.
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |