Função SpbDeviceInitConfig (spbcx.h)

O método SpbDeviceInitConfig anexa a extensão de estrutura do SPB (SpbCx) à cadeia de solicitações de E/S para um objeto WDFDEVICE (FDO ou PDO) que deve ser criado.

Sintaxe

NTSTATUS SpbDeviceInitConfig(
  [in, out] WDFDEVICE_INIT *DeviceInit
);

Parâmetros

[in, out] DeviceInit

Um ponteiro para a estrutura WDFDEVICE_INIT que deve ser configurada.

Retornar valor

SpbDeviceInitConfig retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados incluem o código de erro a seguir.

Comentários

Esse método associa as informações de configuração do SpbCx à estrutura WDFDEVICE_INIT para o objeto de dispositivo (PDO ou FDO) que deve ser criado. A rotina de retorno de chamada EvtDriverDeviceAdd do driver deve chamar SpbDeviceInitConfig antes de chamar o método WdfDeviceCreate para criar o objeto do dispositivo.

Exemplos

O exemplo de código a seguir mostra como usar o método SpbDeviceInitConfig para associar as informações de configuração da extensão da estrutura SpbCx à estrutura WDFDEVICE_INIT .

//
// FxDeviceInit is a pointer to a WDFDEVICE_INIT structure that comes as a
// parameter for an EvtDriverDeviceAdd handler, or from WdfPdoInitAllocate.
//

status = SpbDeviceInitConfig(FxDeviceInit);

if (!NT_SUCCESS(status))
{
    return status;
}

// 
// Set WDF and SpbCx device-level configuration options.
//

...

//
// Call WdfDeviceCreate
//

status = WdfDeviceCreate(&FxDeviceInit,...);

Requisitos

Confira também

EvtDriverDeviceAdd

WDFDEVICE_INIT

WdfDeviceCreate

WdfPdoInitAllocate