IWDFIoRequest::GetOutputMemory 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
GetOutputMemory 메서드는 I/O 요청에 대한 출력 버퍼를 나타내는 메모리 개체를 검색합니다.
통사론
void GetOutputMemory(
[out] IWDFMemory **ppWdfMemory
);
매개 변수
[out] ppWdfMemory
메모리 개체에 대한 참조 계산 IWDFMemory 인터페이스에 대한 포인터를 수신하는 변수에 대한 포인터입니다. NULL 반환하는 것은 유효합니다. 이 경우 출력 메모리가 I/O 요청과 연결되지 않습니다.
반환 값
없음
발언
버퍼링된 I/O 액세스 메서드를 사용하는 드라이버는 GetOutputMemory 호출하여 I/O 요청의 출력 버퍼를 가져올 수 있습니다.
드라이버가 I/O 요청을 완료하기 전에 드라이버는 메모리 개체에 대한 IWDFMemory::Release 메서드를 호출해야 합니다. 요청이 완료되면 기본 메모리 개체가 해제됩니다.
I/O 요청과 연결된 출력 버퍼에는 드라이버가 요청의 발신자에게 제공하는 정보(예: 디스크의 데이터)가 포함됩니다. 드라이버는 GetOutputMemory 호출하여 읽기 요청 또는 디바이스 I/O 제어 요청에 대한 출력 버퍼를 가져올 수 있지만 쓰기 요청에 대해서는 가져올 수 없습니다(쓰기 요청은 출력 데이터를 제공하지 않기 때문). 출력 버퍼에 액세스하려면 드라이버는 IWDFMemory::GetDataBuffer 메서드를 호출해야 합니다.
UMDF는 I/O 요청을 받을 때 I/O 요청을 드라이버의 I/O 큐에 추가하기 전에 I/O 요청의 메모리 개체를 만듭니다. UMDF가 메모리 개체에 대한 메모리를 할당할 수 없는 경우 오류 반환 상태로 I/O 요청을 완료하고 I/O 요청을 드라이버에 전달하지 않습니다.
I/O 요청의 데이터 버퍼에 액세스하는 방법에 대한 자세한 내용은 UMDF-Based 드라이버 데이터 버퍼에 액세스하는참조하세요.
예제
GetOutputMemory 메서드를 사용하는 방법에 대한 코드 예제는 IWDFIoQueue::RetrieveNextRequest참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.5 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |