SerCx2 개체 핸들

아티클
03/18/2023

이 항목에서는 직렬 프레임워크 확장(SerCx2) 버전 2에 대해 특별히 정의된 개체 핸들 형식에 대해 설명합니다.

SerCx2 DDI(디바이스 드라이버 인터페이스)는 이러한 핸들 형식을 사용하여 SerCx2와 관련된 기능과 기능이 있는 개체를 참조합니다.

또한 SerCx2 DDI는 KMDF(Kernel-Mode Driver Framework)에서 정의한 두 가지 제네릭 개체 핸들 형식인 WDFDEVICE 및 WDFREQUEST를 사용합니다.

프레임워크 핸들 형식에 대한 자세한 내용은 프레임워크 개체 요약을 참조하세요.

이 항목에서는 다음 개체 핸들에 대해 설명합니다.

SERCX2CUSTOMRECEIVE 개체 핸들
SERCX2CUSTOMRECEIVETRANSACTION 개체 핸들
SERCX2CUSTOMTRANSMIT 개체 핸들
SERCX2CUSTOMTRANSMITTRANSACTION 개체 핸들
SERCX2PIORECEIVE 개체 핸들
SERCX2PIOTRANSMIT 개체 핸들
SERCX2SYSTEMDMARECEIVE 개체 핸들
SERCX2SYSTEMDMATRANSMIT 개체 핸들

헤더: 2.0\Sercx.h

SERCX2CUSTOMRECEIVE 개체 핸들

SERCX2CUSTOMRECEIVE 개체 핸들은 직렬 프레임워크 확장 버전 2(SerCx2)의 사용자 지정 수신 개체에 대한 불투명 참조입니다.

SerCx2CustomReceiveCreate 메서드는 사용자 지정 수신 개체를 만듭니다. SerCx2는 이 개체를 사용하여 직렬 컨트롤러에서 데이터를 읽는 사용자 지정 데이터 전송 메커니즘을 사용하는 I/O 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다.

SerCx2CustomReceiveCreate 는 새로 만든 사용자 지정 수신 개체에 대한 SERCX2CUSTOMRECEIVE 핸들을 출력 매개 변수로 제공합니다.

SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 SerCx2 메서드 및 이벤트 콜백 함수에 대한 후속 호출에서 개체를 참조합니다.

SerCx2CustomReceiveCreate가 사용자 지정 수신 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. 사용자 지정 수신 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 사용자 지정 수신 개체를 삭제하려고 하면 안 됩니다.

직렬 컨트롤러 드라이버는 옵션으로 사용자 지정 수신 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다.

드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.

드라이버는 이전에 PIO 수신 개체를 만들었습니다.
드라이버가 시스템 DMA 수신 개체를 만들지 않았습니다 .

PIO 수신 개체에 대한 자세한 내용은 SERCX2PIORECEIVE 개체 핸들을 참조하세요.

시스템 DMA 수신 개체에 대한 자세한 내용은 SERCX2SYSTEMDMARECEIVE 개체 핸들을 참조하세요.

SERCX2CUSTOMRECEIVETRANSACTION 개체 핸들

SERCX2CUSTOMRECEIVETRANSACTION 개체 핸들은 SerCx2(직렬 프레임워크 확장) 버전 2의 사용자 지정 수신 트랜잭션 개체에 대한 불투명 참조입니다.

SerCx2CustomReceiveTransactionCreate 메서드는 custom-receive-transaction 개체를 만듭니다. SerCx2는 이 개체를 사용하여 직렬 컨트롤러에서 받은 데이터를 읽는 사용자 지정 데이터 전송 메커니즘을 사용하는 I/O 트랜잭션을 관리합니다.

이 개체는 직렬 컨트롤러 드라이버에 불투명합니다.

SerCx2CustomReceiveTransaction 새로 만든 custom-receive-transaction 개체에 대한 SERCX2CUSTOMRECEIVETRANSACTION 핸들을 출력 매개 변수로 제공합니다.

SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 사용자 지정 수신 트랜잭션에서 개체를 참조합니다.

자세한 내용은 SerCx2 Custom-Receive 트랜잭션을 참조하세요.

SerCx2CustomReceiveTransactionCreate가 사용자 지정 수신 트랜잭션 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다.

사용자 지정-수신 트랜잭션 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다.

직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 사용자 지정 수신 트랜잭션 개체를 삭제하려고 하면 안 됩니다.

직렬 컨트롤러 드라이버는 옵션으로 사용자 지정 수신 트랜잭션 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다.

드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.</wdcml:p>

드라이버는 이전에 PIO 수신 개체를 만들었습니다.
드라이버는 이전에 사용자 지정 수신 개체를 만들었습니다.

PIO 수신 개체에 대한 자세한 내용은 SERCX2PIORECEIVE 개체 핸들을 참조하세요. 사용자 지정 수신 개체에 대한 자세한 내용은 SERCX2CUSTOMRECEIVE 개체 핸들을 참조하세요.

사용자 지정 수신 및 사용자 지정 수신 트랜잭션 개체의 유사한 수명에도 불구하고 이러한 개체 형식은 SerCx2 디바이스 드라이버 인터페이스의 향후 확장을 지원하기 위해 별도의 개체 형식으로 정의됩니다(한 형식으로 결합되지 않음).

SERCX2CUSTOMTRANSMIT 개체 핸들

SERCX2CUSTOMTRANSMIT 개체 핸들은 SerCx2(직렬 프레임워크 확장) 버전 2에서 사용자 지정 전송 개체에 대한 불투명 참조입니다.

SerCx2CustomTransmitCreate 메서드는 사용자 지정 전송 object.h SerCx2를 사용하여 직렬 컨트롤러에 데이터를 쓰는 I/O 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다.

SerCx2CustomTransmitCreate 는 새로 만든 사용자 지정 전송 개체에 대한 SERCX2CUSTOMTRANSMIT 핸들을 출력 매개 변수로 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 SerCx2 메서드 및 이벤트 콜백 함수에 대한 후속 호출에서 개체를 참조합니다.

SerCx2CustomTransmitCreate가 사용자 지정 전송 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다.

사용자 지정 전송 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 사용자 지정 전송 개체를 삭제하려고 하면 안됩니다.

직렬 컨트롤러 드라이버는 옵션으로 사용자 지정 전송 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다.

드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.

드라이버는 이전에 PIO 전송 개체를 만들었습니다.
드라이버가 시스템 DMA 전송 개체를 만들지 않았습니다 .

PIO 전송 개체에 대한 자세한 내용은 SERCX2PIOTRANSMIT 개체 핸들을 참조하세요. 시스템 DMA 전송 개체에 대한 자세한 내용은 SERCX2SYSTEMDMATRANSMIT 개체 핸들을 참조하세요.

SERCX2CUSTOMTRANSMITTRANSACTION 개체 핸들

SERCX2CUSTOMTRANSMITTRANSACTION 개체 핸들은 직렬 프레임워크 확장 버전 2(SerCx2)의 사용자 지정 전송 트랜잭션 개체에 대한 불투명 참조입니다.

SerCx2CustomTransmitTransactionCreate 메서드는 사용자 지정-전송-트랜잭션 개체를 만듭니다. SerCx2는 이 개체를 사용하여 직렬 컨트롤러에 데이터를 쓰는 사용자 지정 데이터 전송 메커니즘을 사용하는 I/O 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다.

SerCx2CustomTransmitTransaction 새로 만든 사용자 지정 전송 트랜잭션 개체에 대한 SERCX2CUSTOMTRANSMITTRANSACTION 핸들을 출력 매개 변수로 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 사용자 지정 전송 트랜잭션에서 개체를 참조합니다.

자세한 내용은 SerCx2 Custom-Transmit 트랜잭션을 참조하세요.

SerCx2CustomTransmitTransactionCreate가 사용자 지정 전송 트랜잭션 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. 사용자 지정 전송 트랜잭션 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 사용자 지정 전송 트랜잭션 개체를 삭제하려고 하면 안됩니다.

직렬 컨트롤러 드라이버는 옵션으로 사용자 지정 전송 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다. 드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.

드라이버는 이전에 PIO 전송 개체를 만들었습니다.
드라이버가 시스템 DMA 전송 개체를 만들지 않았습니다 .

PIO 전송 개체에 대한 자세한 내용은 SERCX2PIOTRANSMIT 개체 핸들을 참조하세요. 사용자 지정 전송 개체에 대한 자세한 내용은 SERCX2CUSTOMTRANSMIT 개체 핸들을 참조하세요.

사용자 지정 전송 및 사용자 지정 전송 트랜잭션 개체의 유사한 수명에도 불구하고 이러한 개체는 SerCx2 디바이스 드라이버 인터페이스의 향후 확장을 지원하기 위해 별도의 개체 형식으로 정의됩니다(한 형식으로 결합되지 않음).

SERCX2PIORECEIVE 개체 핸들

SERCX2PIORECEIVE 개체 핸들은 직렬 프레임워크 확장 버전 2(SerCx2)의 PIO 수신 개체에 대한 불투명 참조입니다.

SerCx2PioReceiveCreate 메서드는 PIO 수신 개체를 만듭니다. SerCx2는 개체를 사용하여 직렬 컨트롤러에서 데이터를 읽는 프로그래밍된 PIO(I/O) 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다. 는 출력 매개 변수로서 새로 만든 PIO 수신 개체에 대한 SERCX2PIORECEIVE 핸들을 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 PIO 수신 트랜잭션에서 개체를 참조합니다.

자세한 내용은 SerCx2 PIO-Receive 트랜잭션을 참조하세요. SerCx2PioReceiveCreate가 PIO 수신 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. PIO 수신 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 PIO 수신 개체를 삭제하려고 하면 안 됩니다.

직렬 컨트롤러 드라이버는 하나의 PIO 수신 개체만 만들어야 합니다. 드라이버는 system-DMA-receive 개체 또는 사용자 지정 수신 개체를 만들기 전에 이 개체를 만들어야 합니다. 시스템 DMA 수신 개체에 대한 자세한 내용은 SERCX2SYSTEMDMARECEIVE 개체 핸들을 참조하세요. 사용자 지정 수신 개체에 대한 자세한 내용은 SERCX2CUSTOMRECEIVE 개체 핸들을 참조하세요.

SERCX2PIOTRANSMIT 개체 핸들

SERCX2PIOTRANSMIT 개체 핸들은 SerCx2(직렬 프레임워크 확장) 버전 2의 PIO 전송 개체에 대한 불투명 참조입니다.

SerCx2PioTransmitCreate 메서드는 PIO 전송 개체를 만듭니다. SerCx2는 이 개체를 사용하여 PIO(프로그래밍된 I/O)를 사용하여 직렬 컨트롤러에 데이터를 쓰는 I/O 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다. SerCx2PioTransmitCreate 는 새로 만든 PIO 전송 개체에 대한 SERCX2PIOTRANSMIT 핸들을 출력 매개 변수로 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 PIO 전송 트랜잭션에서 개체를 참조합니다. 자세한 내용은 SerCx2 PIO-Transmit 트랜잭션을 참조하세요. SerCx2PioTransmitCreate 가 PIO 전송 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. PIO 전송 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 PIO 전송 개체를 삭제하려고 하면 안됩니다.

직렬 컨트롤러 드라이버는 하나의 PIO 전송 개체만 만들어야 합니다. 드라이버는 시스템 DMA 전송 개체 또는 사용자 지정 전송 개체를 만들기 전에 이 개체를 만들어야 합니다. 시스템 DMA 전송 개체에 대한 자세한 내용은 SERCX2SYSTEMDMATRANSMIT 개체 핸들을 참조하세요. 사용자 지정 전송 개체에 대한 자세한 내용은 SERCX2CUSTOMTRANSMIT 개체 핸들을 참조하세요.

SERCX2SYSTEMDMARECEIVE 개체 핸들

SERCX2SYSTEMDMARECEIVE 개체 핸들은 SerCx2(직렬 프레임워크 확장) 버전 2의 시스템 DMA 수신 개체에 대한 불투명 참조입니다.

SerCx2SystemDmaReceiveCreate 메서드는 system-DMA-receive 개체를 만듭니다. SerCx2는 이 개체를 사용하여 직렬 컨트롤러에서 데이터를 읽는 시스템 DMA 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다. SerCx2SystemDmaReceiveCreate 는 새로 만든 시스템 DMA 수신 개체에 대한 SERCX2SYSTEMDMARECEIVE 핸들을 출력 매개 변수로 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 시스템 DMA 수신 트랜잭션에서 개체를 참조합니다. 자세한 내용은 SerCx2 System-DMA-Receive 트랜잭션을 참조하세요.

SerCx2SystemDmaReceiveCreate가 system-DMA-receive 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. 시스템 DMA 수신 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 옵션으로 시스템 DMA 수신 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다. 드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.

드라이버는 이전에 PIO 수신 개체를 만들었습니다.
드라이버가 사용자 지정 수신 개체를 만들지 않았습니다 .

SERCX2SYSTEMDMATRANSMIT 개체 핸들

SERCX2SYSTEMDMATRANSMIT 개체 핸들은 SerCx2(직렬 프레임워크 확장) 버전 2의 시스템 DMA 전송 개체에 대한 불투명 참조입니다.

SerCx2SystemDmaTransmitCreate 메서드는 시스템 DMA 전송 개체를 만듭니다. SerCx2는 이 개체를 사용하여 직렬 컨트롤러에 데이터를 쓰는 시스템 DMA 트랜잭션을 관리합니다. 이 개체는 직렬 컨트롤러 드라이버에 불투명합니다. SerCx2SystemDmaTransmit 새로 만든 시스템 DMA 전송 개체에 대한 SERCX2SYSTEMDMATRANSMIT 핸들을 출력 매개 변수로 제공합니다. SerCx2 및 직렬 컨트롤러 드라이버는 이 핸들을 사용하여 후속 시스템 DMA 전송 트랜잭션에서 개체를 참조합니다. 자세한 내용은 SerCx2 System-DMA-Transmit 트랜잭션을 참조하세요.

SerCx2SystemDmaTransmitCreate가 시스템 DMA 전송 개체를 만든 후 이 개체는 직렬 컨트롤러 디바이스를 나타내는 프레임워크 디바이스 개체의 수명 동안 존재합니다. 시스템 DMA 전송 개체는 디바이스 개체가 삭제될 때 자동으로 삭제됩니다. 직렬 컨트롤러 드라이버는 WdfObjectDelete와 같은 메서드를 호출하여 시스템 DMA 전송 개체를 삭제하려고 하면 안됩니다.

직렬 컨트롤러 드라이버는 옵션으로 시스템 DMA 전송 개체를 만들 수 있지만 이러한 개체를 둘 이상 만들 수는 없습니다. 드라이버는 다음 조건에서만 이 개체를 만들 수 있습니다.</wdcml:p>