Método IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
O método GetCreateParametersEx recupera parâmetros de criação de arquivo associados a um arquivo que está sendo criado ou aberto.
Sintaxe
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
Parâmetros
[out, optional] pOptions
Um ponteiro para uma variável alocada por chamador que recebe sinalizadores de bits que indicam opções de criação de arquivo. Esses sinalizadores de bits nomeados FILE_XXXX são definidos em Wdm.h.
Os 24 bits baixos da variável indicam opções a serem aplicadas ao criar ou abrir o arquivo. Para obter mais informações sobre esses bits, consulte a descrição do parâmetro CreateOptions do modo kernel função ZwCreateFile.
Os oito bits altos da variável indicam ações a serem executadas se o arquivo existir ou ainda não existir. Para obter mais informações sobre esses bits, consulte a descrição do parâmetro CreateDisposition de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pFileAttributes
Um ponteiro para uma variável alocada por chamador que recebe sinalizadores de bits que indicam atributos de arquivo. Esses sinalizadores de bits nomeados FILE_ATTRIBUTE_XXXX são definidos em Wdm.h. Para obter mais informações sobre esses sinalizadores de bits, consulte a descrição do parâmetro FileAttributes de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pShareAccess
Um ponteiro para uma variável alocada por chamador que recebe sinalizadores de bits que indicam opções de compartilhamento de arquivo. Esses sinalizadores de bits nomeados FILE_SHARE_XXXX são definidos em Wdm.h. Para obter mais informações sobre esses sinalizadores de bits, consulte a descrição do parâmetro ShareAccess de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pDesiredAccess
Um ponteiro para uma estrutura de ACCESS_MASK alocada pelo chamador que especifica o acesso solicitado ao arquivo. Para obter mais informações sobre esse parâmetro, consulte o parâmetro DesiredAccess de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
Valor de retorno
Nenhum
Observações
Depois que a estrutura chamar a função de retorno de chamada IQueueCallbackCreate::OnCreateFile do driver, o driver poderá chamar o método IWDFIoRequest::GetCreateParameters ou o método IWDFIoRequest2::GetCreateParametersEx para obter os parâmetros de criação do arquivo.
Para obter mais informações, consulte Obtendo parâmetros para solicitações de E/S.
Exemplos
O exemplo de código a seguir mostra como uma função de retorno de chamada IQueueCallbackCreate::OnCreateFile pode obter a interface de IWDFIoRequest2 e chamar 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);
...
}
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |