SerCxRetrieveReceiveMdl 함수(sercx.h)

SerCxRetrieveReceiveMdl 메서드는 입력 데이터의 다음 블록을 수신하는 데 사용할 버퍼를 설명하는 MDL을 검색합니다.

구문

NTSTATUS SerCxRetrieveReceiveMdl(
  [in]  WDFDEVICE Device,
  [out] PMDL      *Mdl
);

매개 변수

[in] Device

직렬 컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 WDFDEVICE 핸들입니다.

[out] Mdl

메서드가 MDL에 포인터를 쓰는 위치에 대한 포인터입니다.

반환 값

SerCxRetrieveReceiveMdl 은 호출이 성공하면 STATUS_SUCCESS 반환합니다. 가능한 반환 값에는 다음 오류 코드가 포함됩니다.

반환 코드	설명
STATUS_INVALID_DEVICE_REQUEST	다음 중 하나가 발생하면 이 값이 반환됩니다. MDL을 가져올 미해결 수신 요청이 없습니다. 수신된 현재 바이트 수( SerCxProgressReceive 메서드에서 보고됨)는 0이 아닙니다. 버퍼가 이미 검색되었으며 SerCxProgressReceive 메서드에 대한 해당 호출이 아직 발생하지 않았습니다. MDL이 이미 검색되었으며 SerCxProgressReceive 메서드에 대한 해당 호출이 아직 발생하지 않았습니다.

설명

직렬 컨트롤러 드라이버는 이 함수를 호출하여 현재 수신(읽기) 작업에 사용할 MDL을 가져옵니다. MDL은 드라이버가 수신된 데이터를 전송할 버퍼 메모리를 설명합니다. 드라이버는 SerCxProgressReceive 메서드를 호출할 때까지 이 MDL의 단독 소유자이며, 그 후에는 MDL 포인터가 유효하지 않으며 드라이버가 MDL 또는 MDL에서 설명하는 버퍼 메모리에 더 이상 액세스하려고 시도하지 않아야 합니다.

MDL에 대한 자세한 내용은 MDL 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 시작해서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	sercx.h
IRQL	<= DISPATCH_LEVEL

추가 정보

SerCxProgressReceive