WDF_MEMORY_DESCRIPTOR 구조체(wdfmemory.h)

[KMDF 및 UMDF에 적용]

WDF_MEMORY_DESCRIPTOR 구조체는 메모리 버퍼를 설명합니다.

구문

typedef struct _WDF_MEMORY_DESCRIPTOR {
  WDF_MEMORY_DESCRIPTOR_TYPE Type;
  union {
    struct {
      PVOID Buffer;
      ULONG Length;
    } BufferType;
    struct {
      PMDL  Mdl;
      ULONG BufferLength;
    } MdlType;
    struct {
      WDFMEMORY         Memory;
      PWDFMEMORY_OFFSET Offsets;
    } HandleType;
  } u;
} WDF_MEMORY_DESCRIPTOR, *PWDF_MEMORY_DESCRIPTOR;

멤버

Type

이 WDF_MEMORY_DESCRIPTOR 구조체에 포함된 버퍼 설명의 형식을 식별하는 WDF_MEMORY_DESCRIPTOR_TYPE 형식의 값입니다.

u

버퍼를 설명하는 세 개의 구조체로 구성된 합합입니다.

u.BufferType

Type 멤버가 WdfMemoryDescriptorTypeBuffer이면 BufferType 구조체의 멤버는 버퍼를 설명합니다. 이 구조체에는 다음 두 멤버가 포함됩니다.

u.BufferType.Buffer

버퍼에 대한 포인터입니다.

u.BufferType.Length

버퍼의 길이(바이트)입니다.

u.MdlType

Type 멤버가 WdfMemoryDescriptorTypeMdl이면 MdlType 구조체의 멤버는 버퍼를 설명합니다. 이 구조체에는 다음 두 멤버가 포함됩니다.

u.MdlType.Mdl

MDL(메모리 설명자 목록)에 대한 포인터입니다.

u.MdlType.BufferLength

버퍼의 길이(바이트)입니다.

u.HandleType

Type 멤버가 WdfMemoryDescriptorTypeHandle인 경우 HandleType 구조체의 멤버는 버퍼를 설명합니다. 이 구조체에는 다음 두 멤버가 포함됩니다.

u.HandleType.Memory

프레임워크 메모리 개체에 대한 핸들입니다.

u.HandleType.Offsets

메모리 개체가 나타내는 버퍼의 하위 섹션을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다.

설명

WDF_MEMORY_DESCRIPTOR 구조체는 프레임워크의 여러 I/O 대상 개체 메서드 및 USB 디바이스 개체 메서드에 대한 입력으로 사용됩니다.

WDF_MEMORY_DESCRIPTOR 구조를 초기화하려면 드라이버가 WDF_MEMORY_DESCRIPTOR_INIT_BUFFER 호출하거나 WDF_MEMORY_DESCRIPTOR_INIT_MDL 또는 WDF_MEMORY_DESCRIPTOR_INIT_HANDLE 호출해야 합니다.

요구 사항

요구 사항	값
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfmemory.h(Wdf.h 포함)

추가 정보

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE