Função SpbDeviceInitialize (spbcx.h)
O método SpbDeviceInitialize conclui a inicialização do driver do controlador SPB depois que esse driver cria o objeto de dispositivo associado.
Sintaxe
NTSTATUS SpbDeviceInitialize(
[in] WDFDEVICE FxDevice,
[in] PSPB_CONTROLLER_CONFIG Config
);
Parâmetros
[in] FxDevice
Um identificador WDFDEVICE para o objeto de dispositivo que representa o controlador SPB.
[in] Config
Um ponteiro para uma estrutura SPB_CONTROLLER_CONFIG que contém as informações de configuração do dispositivo para o driver do controlador SPB. Essa estrutura deve ter sido inicializada pela função SPB_CONTROLLER_CONFIG_INIT .
Retornar valor
SpbDeviceInitialize retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.
Comentários
O driver do controlador SPB chama esse método para registrar suas funções de retorno de chamada de evento com a extensão da estrutura SPB (SpbCx) e especificar o modo de transferência a ser usado para a fila de E/S do controlador. SpbDeviceInitialize cria todas as estruturas de dados internas do controlador, incluindo a fila de E/S.
O driver do controlador SPB deve chamar esse método antes de confirmar o objeto do dispositivo, ou seja, antes de retornar do retorno de chamada EvtDriverDeviceAdd ou adicionar o PDO à lista filho do controlador. A lista filho representa os dispositivos anexados ao barramento. Para obter mais informações, consulte Enumerando os dispositivos em um barramento.
Depois que SpbDeviceInitialize retornar, o controlador estará pronto para processar solicitações de E/S, mas o driver do controlador SPB pode, conforme necessário, continuar a definir as configurações do controlador antes de confirmar o objeto do dispositivo.
Se a estrutura apontada por Config não for preenchida corretamente, o Verificador de Driver gerará um erro. Para obter mais informações sobre os requisitos para o parâmetro Config , consulte SPB_CONTROLLER_CONFIG.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8. |
| Plataforma de Destino | Universal |
| Cabeçalho | spbcx.h |
| Biblioteca | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |