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 do dispositivo que representa o controlador SPB.
[in] Config
Um ponteiro para uma estrutura de 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.
Valor de retorno
SpbDeviceInitialize retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.
Observações
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 confirma objeto do dispositivo, ou seja, antes de retornar do EvtDriverDeviceAdd retorno de chamada 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 retorna, o controlador está 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 pelo Config não for preenchida corretamente, do Verificador de Driver gerará um erro. Para obter mais informações sobre os requisitos para o parâmetro de configuração, consulte SPB_CONTROLLER_CONFIG.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | spbcx.h |
| biblioteca | Spbcxstubs.lib |
| IRQL | PASSIVE_LEVEL |