Функция SpbDeviceInitConfig (spbcx.h)

Статья
02/07/2025

Метод SpbDeviceInitConfig подключает расширение платформы SPB (SpbCx) к цепочке запросов ввода-вывода для создаваемого объекта WDFDEVICE (FDO или PDO).

Синтаксис

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

Параметры

[in, out] DeviceInit

Указатель на структуру WDFDEVICE_INIT, которую необходимо настроить.

Возвращаемое значение

SpbDeviceInitConfig возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные возвращаемые значения включают следующий код ошибки.

Возвращаемый код	Описание
STATUS_INSUFFICIENT_RESOURCES	Не удается выделить необходимые системные ресурсы.

Замечания

Этот метод связывает сведения о конфигурации spbCx с структурой WDFDEVICE_INIT для создаваемого объекта устройства (PDO или FDO). Подпрограмма обратного вызова драйвера EvtDriverDeviceAdd должна вызывать SpbDeviceInitConfig перед вызовом метода WdfDeviceCreate для создания объекта устройства.

Примеры

В следующем примере кода показано, как использовать метод SpbDeviceInitConfig для связывания сведений о конфигурации расширения SpbCx с структурой 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,...);

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Всеобщий
заголовка	spbcx.h
библиотеки	Spbcxstubs.lib
IRQL	PASSIVE_LEVEL

См. также

Поделиться через