Metodo IWDFIoRequest::GetCreateParameters (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 GetCreateParameters recupera i parametri della richiesta per una richiesta di tipo create.
Sintassi
void GetCreateParameters(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess
);
Parametri
[out, optional] pOptions
Puntatore a una variabile che riceve una maschera di bit di flag che specifica le opzioni applicate durante la creazione o l'apertura del file associato alla richiesta e l'azione da eseguire se il file esiste già.
I 8 bit alti di questo parametro corrispondono al parametro CreateDisposition della funzione ZwCreateFile. Questi 8 bit specificano l'azione da eseguire, a seconda che il file esista già. Si noti che questi valori di eliminazione differiscono dai valori usati nella dwCreationDisposition parametro della funzione CreateFile Win32.
I 24 bit bassi di questo parametro corrispondono al parametro CreateOptions di ZwCreateFile.
Questo parametro è facoltativo. Il driver può passare NULL se il driver non richiede le informazioni.
[out, optional] pFileAttributes
Puntatore a una variabile che riceve una maschera di bit di flag di attributo applicata durante la creazione o l'apertura del file associato alla richiesta. Gli attributi specificati in modo esplicito vengono applicati solo quando il file viene creato, sostituito o, in alcune situazioni, sovrascritto. Per impostazione predefinita, viene specificato il singolo flag FILE_ATTRIBUTE_NORMAL. Tuttavia, questo flag può essere sottoposto a override da qualsiasi altro flag o da una combinazione OR bit per bit di flag compatibili. La maschera di bit dei flag di attributo corrisponde al parametro FileAttributes di ZwCreateFile.
Questo parametro è facoltativo. Il driver può passare NULL se il driver non richiede le informazioni.
[out, optional] pShareAccess
Puntatore a una variabile che riceve una maschera di bit di flag che specificano i diritti di accesso alla condivisione richiesti per il file associato alla richiesta. Se la maschera di bit ricevuta è zero, viene richiesto l'accesso esclusivo. Per altre informazioni sull'accesso alla condivisione, vedere la descrizione del parametro ShareAccess di ZwCreateFile.
Questo parametro è facoltativo. Il driver può passare NULL se il driver non richiede le informazioni.
Valore restituito
Nessuno
Osservazioni
Sebbene il driver possa specificare facoltativamente NULL per ogni pOptions, pFileAttributese parametri pShareAccess, il driver deve specificare almeno un parametro nullnull per GetCreateParameters per l'esecuzione corretta.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |