SerCxInitialize 함수(sercx.h)
SerCxInitialize 메서드는 이 드라이버가 연결된 디바이스 개체를 만든 후 SerCx(직렬 프레임워크 확장)의 초기화를 완료합니다.
구문
NTSTATUS SerCxInitialize(
[in] WDFDEVICE FxDevice,
[in] PSERCX_CONFIG Config
);
매개 변수
[in] FxDevice
직렬 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 WDFDEVICE 핸들입니다.
[in] Config
SerCx에 대한 구성 정보를 포함하는 호출자가 할당한 SERCX_CONFIG 구조체에 대한 포인터입니다. 호출자는 이전에 이 구조를 초기화하기 위해 SERCX_CONFIG_INIT 함수를 호출했습니다.
반환 값
SerCxInitialize 는 성공하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.
반환 코드 | 설명 |
---|---|
|
메서드가 잘못된 IRQL에서 호출되었습니다. 또는 WDFDEVICE 핸들이 잘못되었습니다. 또는 FxDevice 또는 Config 가 NULL입니다. |
|
시스템 리소스(일반적으로 메모리)를 할당할 수 없습니다. |
설명
직렬 컨트롤러 드라이버는 연결된 디바이스 개체를 만든 후 이 메서드를 호출합니다.
SerCxInitialize 는 컨트롤러 드라이버의 I/O 콜백 함수를 SerCx에 등록합니다. 또한 이 메서드는 I/O 큐에 대한 전송 모드를 정의합니다. 호출하는 동안 이 메서드는 SerCx에 필요한 모든 내부 구조(직렬 컨트롤러에 대한 I/O 큐 포함)를 만듭니다. 이 메서드가 반환되면 SerCx는 I/O를 처리할 준비가 됩니다. 그러나 컨트롤러 드라이버는 EvtDriverDeviceAdd 콜백에서 반환되기 전에 또는 자식 목록에 PDO를 추가하기 전에 컨트롤러 하드웨어 설정을 구성할 수 있습니다.
매개 변수가 잘못된 경우( SERCX_CONFIG 설명한 대로) 드라이버 검증 도구 에서 오류가 발생합니다.
디바이스를 커밋하기 전에 이 루틴을 호출해야 합니다( EvtDriverDeviceAdd 에서 반환하거나 자식 목록에 PDO 추가).
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 시작해서 사용할 수 있습니다. |
대상 플랫폼 | 유니버설 |
헤더 | sercx.h |
IRQL | PASSIVE_LEVEL |