Método IWDFDevice2::GetDeviceStackIoTypePreference (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método GetDeviceStackIoTypePreference recupera os métodos de acesso ao buffer que a estrutura está usando para um dispositivo.
Sintaxe
void GetDeviceStackIoTypePreference(
[out] WDF_DEVICE_IO_TYPE *ReadWritePreference,
[out] WDF_DEVICE_IO_TYPE *IoControlPreference
);
Parâmetros
[out] ReadWritePreference
Um ponteiro para um local alocado pelo driver que recebe um valor tipado por WDF_DEVICE_IO_TYPE. Esse valor identifica o método de acesso ao buffer que a estrutura está usando para solicitações de leitura e gravação de um dispositivo.
[out] IoControlPreference
Um ponteiro para um local alocado pelo driver que recebe um valor tipado por WDF_DEVICE_IO_TYPE. Esse valor que identifica o método de acesso ao buffer que a estrutura está usando para solicitações de controle de E/S de um dispositivo.
Retornar valor
Nenhum
Comentários
Se o driver chamar GetDeviceStackIoTypePreference antes que o gerenciador de PnP tenha carregado todos os drivers do dispositivo, os valores recuperados por GetDeviceStackIoTypePreference podem não ser os valores que ele realmente usa.
Para obter mais informações sobre como a estrutura escolhe um método de acesso ao buffer, consulte Como o UMDF escolhe um método de acesso de buffer para uma solicitação de E/S.
Exemplos
O exemplo de código a seguir recupera os métodos de acesso ao buffer que a estrutura está usando para um dispositivo.
WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;
Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
&IoControlAccessMethod);
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1,9 |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |